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MANUAL  OBJECTIVES 

The  RSX-llM/M-PLUS  System  Management  Guide  documents  system  programs 
and  procedures  that  test,  monitor ,  maintain,  and  customize 
RSX-llM/M-PLUS  operating  systems  after  system  generation. 


INTENDED  AUDIENCE 

This  manual  is  intended  for  system  managers,  operators,  and  system 
programmers  who  perform  system  management  functions.  The  manual  is 
not  intended  for  general  users  or  applications  programmers. 


STRUCTURE  OF  THE  MANUAL 

The  RSX-llM/M-PLUS  System  Management  Guide  consists  of  18  chapters  and 
two  appendixes  as  follows: 

Chapter  1  summarizes  each  program  and  procedure  described  in  Chapters 
2  through  18. 

Chapter  2  describes  how  you  use  the  Account  File  Maintenance  Program 
(ACNT)  to  create  and  maintain  accounts  on  multiuser  protection 
systems. 

Chapter  3  describes  how  you  use  the  Console  Logger  to  handle  I/O  to 
the  console  output  device  (CO) :  and  rejord  system  messages  at  a 
terminal  and/or  in  a  log  file. 

Chapter  4  describes  how  you  use  the  I/O  Exf"::iser  (lOX)  .o  detect  and 
diagnose  I/O  problems  on  the  disk  and  ape  units  in  your  system's 
hardware  configuration. 

Chapter  5  describes  how  the  Bad  Block  Replacement  Control  Task  (RCT) 
performs  bad  block  handling  and  recovery  on  Mass  Storage  Control 
Protocol  (MSCP)  devices  such  as  the  RA80. 

Chapter  6  describes  how  you  use  the  Resource  Monitoring  Display  (RMD) 
to  display  information  about  the  active  tasks  in  your  operating  system 
and  the  availability  of  system  resources. 

Chapter  7  describes  how  to  set  up  the  Queue  Manager  for  the 
convenience  of  multistream  line-printer  spooling. 

For  RSX-llM-PLUS  systems  only,  this  chapter  describes  how  you  set  up 
batch  processors  that  enable  you  to  direct  a  command  sequence  to  the 
operating  system  at  a  predetermined  time  of  day. 
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Chapter  8  describes  how  you  use  the  SHUTUP  Program  to  shut  down  the 
system  in  an  orderly  fashion. 

Chapter  9  describes  how  you  use  the  User  Environment  Test  Package 
(UETP)  after  system  generation  to  verify  that  you  have  generated  a 
working  operating  system. 

Chapter  10  descrioes  how  you  use  the  Virtual  Monitor  Console  Routine 
(VMR)  to  alter  a  system  image  file  on  disk. 

Chapter  11  describes  command  line  interpreter  tasks,  how  to  write 
them,  and  the  use  of  new  Executive  directives  in  them. 

Chapter  12  describes  how  to  task  build  and  install  the  DCL  task  with 
various  options.  It  also  describes  the  Macro  Meta  language,  which  is 
a  set  of  macros  that  describes  the  mapping  from  DCL  syntax  to  MCR 
syntax.  With  this  language,  you  can  alter  or  add  commands  to  extend 
DCL. 

Chapter  13  describes  the  Pool  Monitoring  Support  that  controls  the  use 
of  the  system's  dynamic  storage  region  (pool). 

Chapter  14  describes  the  Shuffler,  which  is  a  task  that  compacts 
memory  space  in  system-controlled  partitions. 

Chapter  15  describes  how  you  use  the  RSX-llM-PLUS  reconfiguration 
services  (CON  and  HRC)  to  reconfigure  system  resources  to  isolate  the 
system  from  the  effects  of  faulty  hardware  elt-jnents. 

Chapter  16  describes  RSX-llM-PLUS  I/O  Queue  Optimization,  which 
improves  the  throughput  of  the  disk  subsystems  used  in  your  system. 

Chapter  17  describes  RSX-llM-PLUS  Resource  Accounting,  which  creates  a 
transaction  file  of  system  usage  information. 

Chapter  18  describes  RSX-llM-PLUS  Shadow  Recording,  which  allows  your 
system  to  back  up  all  information  being  written  to  a  Files-11  disk. 

Appendix  A  describes  the  Serial  Despooler,  which  is  superseded  by  the 
Queue  Manager  to  handle  line-printer  spooling  for  most  systems. 

Appendix  B  describes  the  set  of  User  File  Directory  (UFD)  conventions 
observed  by  the  operating  system  for  files  on  disk.  A  section  of 
file-naming  conventions  is  also  included. 


ASSOCIATED  MANUALS 

Before  you  read  this  manual,  you  should  be  familiar  with  the 
RSX-llM/M-PLUS  MCR  Operations  Manual,  the  RSX-llM/M-PLUS  Utilities 
Manual ,  and,  for  DIGITAL  Command  Language  users,  the  RSX-llM/M-PLUS 
Command  Language  Manual .  Although  you  do  not  need  to  read  the  RSX-llM 
System  Generation  and  Installation  Guide  or  the  RSX-llM-PLUS  System 
Generation  and  Installation  Guide  before  reading  this  manual,  system 
generation  logically  precedes  your  use  of  the  programs  and  procedures 
documented  in  this  manual. 
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CONVENTIONS  USED  IN  THIS  MANUAL 

Convention  Meaning 

i^ed  ink  Designates   user    input.     Responses    from 

programs  are  designated  in  black  ink, 

blue  ink  Designates  RSX-llM-PLUS  multiprocessor  system 

information. 

•••                 A   horizontal   ellipsis   indicates  that   the 

command   line   element   immediately  preceding 

the  ellipsis  can  be  repeated  one  or  more 
tiiTies. 

A  vertical  ellipsis  indicates  that  part  of  a 
.  command  sequence  or  program  output   continues 

•  but  is  not  relevant  to  the  discussion  of   the 

example. 

lowercase  In   a   command   line,   lowercase   words    and 

letters  indicate  that  you  substitute  a  value. 
Usually  the  lowercase  word  describes  the 
value  to  be  substituted. 

UPPERCASE  Command  elements  other  than   those   shown   in 

lowercase  for  which  you  substitute  a  value 
are  always  uppercase.  Within  descriptions, 
these  command  elements  are  never  truncated. 
In  examples,  they  may  be  truncated  according 
to  the  rules  of  the  particular  program. 

O  A  reverse  number  is  a  white  number  printed  in 

a  black  circle.  These  numbers  key  a  part  of 
an  example  to  the  text  that  explains  that 
part  of  the  example.  "^he  reverse  number 
appears  both  in  the  example  and  the 
explanation. 

[optional]  Square  brackets  indicate   that   the   enclosed 

item  is  optional. 

shading  Shaded  portions  of   text  describe   only  one 

operating  system. 

Gray  shading  indicates  that  the  text 
describes    only    RSX-llM-PLUR   operatina 


r«u  *  :a  t  . 


RSX-llM-PLUS.    ''      "'    '  '    "  -""-^--  '■"-. 

Red  shading  iidicates  that  the  text  describes 
only  RSX-llM  operating  systems. 

Portions  of  text  that  are  not  shaded  describe 
both  operating  systems,  except  in  the 
RSX-llM-PLUS-only  chapters. 

@rx)  The  symbol  CTRL/x  indicates  that  you  press   a 

key  while  simultaneously  pressing  and  holding 
down  the  CTRL  key;  for  example,  CTRL/C, 
CTRL/0. 
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SUMMARY  OF  TECHNICAL  CHANGES 


The  RSX-1 IM/M-PLUS  System  Management  Guide  documents  these  new 
capabilities  of  RSX-llM  V4.0  and  RSX-llM-PLUS  V2.0: 

1.  The  Bad  Block  Replacement  Control  Task  (RCT)  performs  bad 
block  handling  and  recovery  on  Mass  Storage  Control  Protocol 
(MSCP)  devices  such  as  the  RA80. 

2.  DIGITAL  Command  Language  is  available  on  RSX-llM  V4.0. 

3.  You  can  augment  the  DIGITAL  Command  Language  with  your  own 
commands  and  write  your  own  command  language  interpreters. 

The  other  programs  and  procedures  described  in  this  manual  have  all 
been  enhanced  to  include  new  functionality.  The  following  lists 
descriptions  of  new  software  and  the  enhancements  to  previously 
existing  software  for  RSX-llM  V4.0  and  RSX-llM-PLU?  V2.0. 


Account  File  Maintenance  Program  (ACNT) 

1.  When  adding  or  modifying  an  account  entry,  you  can  specify  a 
default  command  language  interpreter  (CLI). 

2.  When  adding  or  modifying  an  account  entry,  you  can  specify 
whether  or  not  the  terminal  on  which  a  user  logs  in  is  to  be 
a  slaved  terminal . 

3.  You  can  specify  logical  device  names  as  the  user's  default 
device  (SY: ) . 


Console  Logger 

1.  You  interface  with  the  Console  Logger  with  one   keyword   from 
MCR  or  DCL  instead  of  five. 

2.  Tasks  can  read  from  the  console  terminal. 

3.  The   Console   Logger   time-stamps   messages   written   to   the 
console  output  device  (CO:). 


I/O  Exerciser  (lOX) 

1.   Three  new  commands: 

a.   COIPARPDATA  allows  you  to  jisable  data  comparisons  during 
testing. 
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fc.  RANGE  allows  you  to  determine  the  range  of  blocks  to  be 
tested  on  nonf ile-structured  disks.  You  can  also  use 
RANGE  to  display  the  current  range  of  blocks  to  be  tested 
on  the  specified  disk. 

c.  RECORDS  allows  you  to  specify  the  number  of  records  to 
test  on  magnetic  "-.apes  and  cassettes, 

2.  The  ITERATIONS  command  has  been  eliminated. 

3.  The  FILESll,  SELECT,  and  VERIFY  commands  ha^/e  been  modified 
to  accept  commands  in  their  command  lines  that  set  exercise 
parameters. 

4.  Exercising  of  magnetic  tapes  and  DECtapes  has  been  improved 
to  allow  testing  of  the  entire  tape  and  the  testing  of  one 
tape  while  another  is  rewinding. 

5.  The  CONFIGURE  command  allows  you  to  specify  multiple  units 
per  command  line.  CONFIGURE  also  accepts  any  disk  or  tape 
unit  to  which  you  can  assign  a  logical  name  with  the  MCR  ASN 
command . 

6.  The  EXECUTE  command  sends  leading  blanks  to  the  task  to  be 
executed. 

7.  You  can  use  CTRL/0  with  the  PARAMETERLIST  and  PRINTSUMMARY 
commands  while  no  exercising  is  in  progress. 

8.  The  random  data  pattern  from  pure  portions  of  the  lOX  task  is 
the  default  pattern. 

Resource  Monitoring  Display  (RKD) 

1.  Two  new  displays  have  been  added:  Active  Task  Display  and 
Task  Header  Display. 

2.  RMD  parses  an  MCR  command  line  so  that  you  can  select  a 
display  page  and  enter  setup  commands  from  the  MCR  command 
line. 

3.  The  Memory  Display  includes  a  DECnet  node  name  or  system 
name. 


Setting  Up  and  Running  the  Queue  Manager 

1.  MCR  and  DCL  are  supported. 

2.  Naming  conventions  for  the  spooled  output  device,  the 
device-specific  queues  (colon  optional),  the  device  Itself, 
and  the  processor  that  "owns"  the  device  (colon  optional) 
have  been  changed  so  that  these  entities  all  have  the  same 
name;   for  example,  LPO:. 

3.  You  can  now  initialize  print  processors  as  shareable.  This 
means  that  a  line  printer  is  not  permanently  attached.  It  is 
attached  only  while  the  Queue  Manager  is  passing  a  print  job 
to  it. 

—   4.   For  RSX-llM  systems,  you  now  have  to  explicitly  create  the 
device-specific  queues. 
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SUfWART  or  TBCBMICAL  CRAMGBS 

8M0T0P  ProgrM 

1.  Messages  Include  a  DECnet  node  name  or  system  name. 

2.  The  NOBROADCAST  bit  is  honored  except  during   the   last   five 
minutes  before  shutdown. 

3.  The  message  "SHUTUP  operation  complete*  is  output  before   the 
system  halts. 

4.  A  task-build  option  lets  you  specify  the   time<-out   interval 
for  (1,2)SHUTUP.CMD. 


Oaer  Environment  Test  Package  (OETP) 

1.  You  can  specify  devices  to  be  excluded  from  testing. 

2.  You  can  determine  how  many  times  to  run  UETP. 

3.  You  can  select  one  oc  more  of  the  five  UETP  tests. 

4.  UETP  prints  a  message  identifying  the  test  and   the   time   at 
the  start  and  end  of  each  test. 

5.  UETP  searches  for  RSXMC.MAC. 

Virtual  Monitor  Console  Routine  (VMR) 

VMR  can  now  fix  and  unfix  tasks  in  system-controlled  partitions  on 
mapped  systems.  Both  the  mapped  and  unmapped  vitsions  of  VMR  can  be 
used  to  fix  and  unfix  a  task. 

The  following  are  new  or  revised  commands  for  VMR: 

FIX  New  keywords  are: 

/DIR  (ASX-llM-PLUS  systems  only.)   Specifies 

that  the  task  to  be  fixed  is  a  directive 
common . 

/NSF  (RSX-llM-PLUS  systems  only.)   Specifies 

that   the   task   to   be   fixed  will   be 
i;^  nonshuf  f  leable. 

INS  New  keywords  are: 

/CLI  Specifies  that  the  task  being   installed 

is  a  command  line  interpreter  (CLI). 

/FIX  (RSX-llS    systems    only.)     Specifies 

whether  memory-resident  tasks  on  RSX-llS 
will  be  fixed  in  memory. 

/lOP  Specifies  that  a   privileged   task   can 

overmap  the  I/O  page. 

/SEC  (RSX-llM-PLUS  systems  only.)   Placas   in 

secondary  pool   the  Task  Control  Block 
I  for  the  task  being  installed. 
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SAVE 


SIT 


/SYNC 


/XHR 


(RSX-1 IM-PLUS  multiprocessor  systems 
only.)  Synchronizes  task  use  o£  a  common 
region. 

(RSX-l IN-PLUS  syatMs  only.)  Specifics 
that  th«  Executive's  copy  of  a  task's 
header  will  be  kept  in  an  area  external 
to  the  systea's  dynaaic  storage  area 
(pool). 


New  keywords  are 
/BOOT 


/DENS 


Allows  a  system  saved  on  an  RX02  to  be 
booted  on  RXOl  and  vice  versa. 

Specifies  1600  bpi  density  for  the 
fol''owing  magnetic  tapes:  TE16,  TU16, 
TU-wS,  and  TU77. 


New  or  revised  keywords  are: 


/ABAUD 
/BRO 

/MAXEXT 

/NETUIC 
/OPT 

/PLCTL 

/PUB 
/REMOTE 

/RNDC 
/RNDH 

/RNDL 

/SECPOL 


Enables  autobaud  detection  for  a 
terminal's  remote  dial-up  line. 

Specifies  whether  a  terminal  will 
receive  mes'.ages  from  the  MCR  BROADCAST 
command. 

Establishes  the  maximum  size  to  which  a 
task  can  extend  itself  by  means  of  the 
Executive  EXTEND  TASK  directive. 

Specifies  the  UIC  in  which 
DECnet-re] ated  tasks  will  be  stored. 

(RSX-llM-PLUS  systens  only.)  Enables 
disk  I/O  queue  optimization  for  a 
device. 

Displays  or  sets  the  pool  limit 
parameters  used  by  the  Pool  Monitor  Task 
(PMT) . 

Displays  or  sets  a  device  public  (/PUB) 
or  nonpublic  (/NOPUB)  . 

Now  allows  the  setting  of  the  initial 
baud  rate  of  a  remote  dial-up  line  for  a 
terminal . 

Defines  the  length  of  the  Executive 
round-robin  scheduling  interval. 

Defines  the  highest  priority  that  will 
be  considered  for  Executive  round-robin 
scheduling . 

Defines  the  lowest  priority  that  will  be 
considered  for  Executive  round-robin 
schedul ing. 

(RSX-llM-PLUS  systems  only.)  Displays 
secondary  pool  use  in  the  system. 
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/SWPC  Defines  the  length  of  a  single  Executive 

swapping  interval. 

/SWPR  Defines  a  priority  range  for  Executive 
swapping. 

/TERM  New  terminal  types  allowed:  LA12,  LA34, 
LA38,  LAIOO,  VTlOl,  VT102,  VT105,  VT125, 
VT131,  and  VT132. 

t/0  Qaou*  optiaisatlen 

A  new  chapter  describes  how  RSX-11M-PLU8  users  can  iaprovs  throughput 
of  disk  subsystems. 

Rssoatrcs  Aceoontiim 

The  RSX-liNoPLUS  Resource  Accounting   dsscriptlon   contains   the 
following  new  infomatlon: 

1.  You  can  specify  that  task  accounting  be  performed. 

2.  you  can  convert  a  transaction  file  to  one  that  is  readable  by 
DATATRIEVE-Il.  This  allows  you  to  write  a  resource  accounting 
report  program  in  DATATRIBVE-11. 

3.  You  can  collect  device  statistics  for  disk  subsystems. 
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CHAPTER  1 
INTRODUCTION 


This  chapter  summarizes  the  functions  of  the  programs  and  procedures 
documented  in  the  chapters  of  this  manual.  Each  chapter  is  summarized 
in  the  order  in  which  it  is  presented  in  the  manual. 


Chapter  2  -  Account  File  Maintenance  Program  (ACNT) 

The  Account  File  Maintenance  Program  (ACNT)  allows  a  privileged  user 
to  create  and  maintain  an  account  file  on  multiuser  protection 
systems.  Each  account  entry  consists  of  such  information  as  an 
account  number  (the  user's  UIC)  nnd  password,  default  device  (SY:), 
users  first  and  last  name,  and  default  command  language  interpreter 
(CLI).  ACNT  allows  a  privileged  user  to  create  an  account  file,  add 
and  delete  accounts,  modify  accounts,  list  the  accounts,  examine  an 
individual  account,  and  sort  the  account  entries. 

The  chapter  gives  an  example  of  how  to  use  each  ACNT  function. 


Chapter  3  -  Console  Logger 

The  Console  Logger  consists  of  a  driver  (CODRV)  and  a  task  (COT...) 
that  handle  I/O  to  the  console  output  device  (CO:)  and  record 
time-stamped  system  messages  on  a  terminal  and/or  in  a  log  file.  You 
use  MCR  SET  commands  from  a  privileged  terminal  to  start  and  stop 
~onsole  logging,  disable  the  log  file  or  the  console  terminal,  and 
reassign  the  log  file  and  console  terminal.  You  select  Console  Logger 
support  during  SYSGEN. 

The  chapter  documents  the  console  logging  commends  ano  presents  an 
extensive  terminal  session  with  explanations  of  the  commands  used  in 
the  session. 


Chapter  4  -  I/O  Exerciser  (lOX) 

The  I/O  Exerciser  (lOX)  detects  and  diagnoses  I/O  problems  on  the  disk 
and  tape  units  in  your  system's  hardware  configuration.  lOX  exercises 
Files-11  disks,  non-file-structured  disks,  magnetic  tapes,  DECtapes, 
and  cassettes.  lOX  performs  three  kinds  of  exercises.  The  lOX 
Command  Language  enables  you  to  specify  and  control  the  exercise  for 
the  units  in  your  system.  You  choose  an  exercise  appropriate  to  a 
unit  and  set  exercise  parameters  that  determine  how  the  unit  is 
exercised. 
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The  chapter  documents  each  lOX  command  in  alphabetical  order  and  gives 
examples  that  illustrate  and  explain  how  to  set  parameters  for  the 
three  kinds  of  lOX  exercises. 


Chapter  5  -  Bad  Block  Replacement  Control  Task  (RCT) 

The  Bad  Block  Replacement  Control  Task  (RCT)  handles  bad  block 
replacement  and  recovery  on  Mass  Storage  Control  Protocol  (MSCP)  disks 
such  as  the  RA80.  Bad  block  handling  on  MSCP  disks  consists  of  four 
stages:  detecting,  notifying,  replacing,  and  revectoring.  The  disk 
controller  (UDA50)  detecl.s  bad  blocks  and  notifies  the  driver  (DUDRV) . 
The  driver  activates  RCT.  RCT  performs  the  bad  block  replacement 
functions  that  enable  the  controller  to  revector  (redirect)  I/O  from 
the  bad  block  to  t'le  replacement  block. 

RCT  also  per'")rms  replacement  and  recovery  on  MSCP  disks  that  went  off 
line  durint  bad  block  replacement  or  before  the  contents  of  a 
write-back  cache  were  copied  to  the  disk. 


Chapter  6  -  Resource  Monitoring  Display  (RMD) 

The  Resource  Monitoring  Display  (RMD)  provides  information  about  thp 
active  tasks  in  your  operating  system  and  the  availability  of  systei 
resources.  This  information  includes  the  active  tasks,  their  location 
in  memory,  the  amount  of  memory  they  occupy,  and  the  available  pool 
space.  RMD  generates  dynamic  displays  on  CRTs  and  "snapshot"  displays 
on  hardcopy  terminals. 

There  are  three  displays:  memory,  active  task,  and  task  header. 
There  is  also  a  help  page  that  tells  you  how  to  switch  display  pages. 
Each  display  page  has  a  setup  page  from  which  you  can  alter  the 
contents  of  the  associated  display  page.  You  can  access  any  RMD 
display  and  alter  the  contents  of  the  display  from  the  MCR  command 
line. 

On  RSX-llM-PLUS  systems,  a  system  statistics  display  and  error  log 
count  display  are  also  available. 

The  chapter  contains  an  example  and  explanation  of  the  memory  display. 


Chapter  7  -  Setting  Up  and  Running  the  Queue  Manager  (QMG) 

"^h"     ■■"!-■:"     "-:^-^'1^^      <,;,..--.      ;- -  _     -u-     __;___^.     £..__^j._        ^.r         -ontr^llifig        the 

ayscem's  line  printers  and  the  print  jobs  to  be  passed  to  them.  Users 
can  specify  the  number  of  copies  they  want  printed,  the  time  the  job 
is  to  be  released  for  printing,  whether  the  file  is  to  be  deleted 
after  printing,  and  which  printer  they  want  to  use.  Users  can  display 
all  information  about  the  QMG  queues  and  can  alter  the  characteristics 
of  jobs  in  queues.  Gome  installations  may  have  user-written  output 
processors  that  pass  jobs  to  devices  other  than  line  printers.  The 
nonpr ivilpged  functions  of  QMG  are  documented  in  the  RSX-llM/M-PLUS 
Batch  and  Queue  Operations  Manual . 

This  chapter  documents  the  privileged  system  management  functions  of 
QMG.  Systems  can  have  as  many  as  16  output  queues  (including  the 
default  PRINT  queue)  and  16  output  processors.  Print  processors  can 
be  initialized  to  print  a  specified  number  of  flag  pages  before  each 
print  job,  to  accept  or  reject  print  jobs  specifying  that  lowercase 
printing  is  required,  and  to  handle  many  kinds  of  printed  forms. 
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On  RSX-llM-PLUS  systems,  QNG  also  supports  b4tch  processing. 
RSX-llM-PLUS  systems  can  have  as  many  as  16  batch  r^ueues  and  16  batch 
processors. 

The  chapter  includes  an  illustrated  explanation  for  setting  up  the 
Queue  Manager. 


Chapter  8  -  The  SHUTUP  Program 

The  SHUTUP  irogram  allows  a  privileged  user  to  shut  down  the  system  in 
an  orderly  fashion.  SHUTUP  prompts  for  the  number  of  minutes  to  wait 
before  shutdown,  the  number  of  minutes  between  shutdown  messages,  and 
the  number  of  minutes  to  wait  before  disabling  logins.  Before  halting 
the  system,  SHUTUP  performs  cleanup  functions  such  as  logging  off  all 
logged-in  terminals,  submitting  the  user-written  command  file 
LB: ( 1 , 2)SHUTUP.CMD  to  Indirect  for  execution,  stopping  the  Queue 
Manager,  Console  Logger,  and  Error  Logger  (if  present),  deallocating 
checkpoint  space,  and  dismounting  mounted  devices. 

The  chapter    ovides  an  example  and  explanation  of  SHUTUP  output. 


Chapter  9  -  User  Environment  Test  Package  (UETP) 

The  User  Environment  Test  Package  (UETP)  is  used  after  system 
generation  to  verify  that  you  have  generated  a  working  operating 
system.  UETP  con'^ists  of  several  command  files  that  verify  the 
presence  and  operation  of  devices,  test  the  basic  Executive  features, 
and  verify  the  presence  of  system  utilities. 

UETP  consists  of  five  test  dules:  Load  Test,  I/O  Exerciser  Test, 
Utilities  Test,  MCR  Commanc  .est,  and  Interactive  Utilities  Test.  You 
can  select  which  of  these  tests  to  run,  indicate  how  many  times  to  run 
UETP,  select  or  omit  extended  comments,  and  exclude  devices  from 
test  ing. 

The  chapter  contains  a  sample  UETP  terminal  session. 


Chapter  10  -  Virtual  Monitor  Console  Routine  (VMR) 

The  Virtual  Monitor  Console  Routine  (VMR)  is  a  task  that  contains  a 
subset  of  the  Monitor  Console  Routine  (MCR)  commands.  You  use  VMR  to 
make  the  same  changes  to  the  system  image  file  on  disk  that  you  would 
make  to  the  running  system  with  MCR  Some  of  these  changes  are 
setting  the  size  of  pool,  creating  partitions,  loading  drivers,  and 
installing  tasks.  The  advantage  of  using  VMR  is  that  you  can  almost 
completely  configure  a  system  image  file  before  you  boot  it. 

The  chapter  presents  each  of  the  VMR  commands  in  alphabetical  order. 


Chapter  11  -  Command  Language  Interpreters 

A  command  line  interpreter,  or  CLI,  is  a  task  that  services 
unsolicited  commands  meant  for  the  operating  system  or  an  application. 
These  commands  are  not  prompted  for  by  any  task  nor  ar<?  they  ^iven  to 
a  task  by  a  read  optr^tion  on  a  terminal.  The  best  known  CLI  on 
RSX-ilM/M-PLUS  is  MCR,  which  controls  che  operating  system. 
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A  CLI  is  also  an  efficient  means  of  Interfacing  an  application  command 
processor  to  any  number  of  terminals,  because  no  read  QIC  or  character 
AST  processing  is  involved. 

This  chapter  introduces  the  concepts  of  CLIs  on  RSX-llM/M-PLUS 
systems.  The  chapter  includes  enough  information  to  allow  the 
programmer  to  write  application-specific  CLIs. 


Chapter  12  -  The  DCL  Task 

The  DIGITAL  Command  Language  (DCL)  is  a  general  purpose  command 
language  syntax  implemented  on  several  DIGITAL  operating  systems. 

This  chapter  explains  the  ways  in  which  DCL  can  be  installed  on  your 
system  and  documents  the  means  by  which  the  DCL  task  parses  and 
translates  commands.  In  addition,  this  chapter  documents  the  Macro 
Meta  Language,  a  sec  of  MACRO-11  macros  used  to  define  DCL.  An 
experienced  programmer  can  add  commands  to  DCL  or  remove  them,  or 
alter  DCL  by  changing  parts  of  DCL,  such  as  altering  defaults  or 
eliminating  qualifiers. 


Chapter  1?.  -  Pool  Monitorinq  Support 

Pool  monitoring  support  controls  the  use  of  the  system's  dynai;>  c 
storage  region  (pool).  This  support  monitors  pool  levels,  restricts 
use  of  poo?,  and  notifies  you  when  pool  is  near  depletion.  This 
support  consists  of  two  parts:  the  RSX-llM/M-PLUS  Executive  pool 
monitor  code  and  the  privileged  Pool  Monitor  Task  (PMT). 


Chapctr  14  -  Shuffler  Support 

The  Shuffler  (SHF)  is  a  privileged  task  that  compacts  space  in 
system-controlled  partitions  when  a  memory  allocation  failure  occurs. 
The  Shuffler  operates  only  within  system-controlled  partitions.  This 
chapter  describes  Shuffler  structure.  Shuffler  interaction  with  the 
operating  system,  ways  to  monitor  the  Shuffler,  and  Shuffler 
algorithms  for  the  operating  system. 


Chapter  15  -  RSX-llN-PLUS  Reconfiguration  Services 

The  reconfiguration  services  consist  of  two  tasks  (CON  and  HRC)  and  a 
driver  (RD;).  With  the  services,  you  can  alter  or  display  information 
about  various  system  resources  such  as  devices  and  memory.  The  main 
purpose  of  the  reconfiguration  services  is  to  allow  you  to  isolate 
faulty  hardware  so  that  it  does  not  affect  the  system  adversely. 

The  chapter  describes  the   functions  of  CON,   HRC,   and  RD:  and 

describes  the  reconfiguration  commands  and  gives  examples  of  using 

each  one.  The  chapter  also  gives  procedures  for  recovering  from 
various  hardware  errors. 
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Chaptar  16  -  R8X-11N-PLUS  I/O  QUBUE  OPTIMIZATION 

I/O  Quttue  Optinization  is  used  to  improve  the  throughput  of  the  disk 
subsystems  used  in  your  RSX-1.1M-PLUS  system.  This  is  done  by  making 
the  most  effective  use  of  the  list  of  I/O  requests  in  the  queue  for  a 
particular  disk  device.  Three  methods  of  optimization  are  provided: 
Nearest  Cylinder,  Elevator,  and  Cylinder  Scan. 


Chapter  17  -  RSX-llM-PLUS  RESOURCE  ACCOUNTING 


Resource  Accounti 
information.  In 
total  system  util 
individual  users 
system  performanc 
you  can  determi 
how  much  CPU  time 
system  utilizati 
logons,  how  much 
information.  The 
or  you  can  write 


ng  provides  a  transaction  file  of  system  usage 
formation  is  gathered  on  each  user  in  a  system  and  on 
ization.  This  information  can  be  used  to  bill 
for  the  resources  used  and  for  measuring  overall 
e.  By  analyzing  the  data  in  the  transaction  file, 
ne   such  things  as  who  used  the  system,  for  how  long, 

they  used,  and  a  number  of  other   statistics.    For 

on,   you  can  find  out  the  number  of  users,  number  of 

input/output  was  done,   and  other  system  usage 

information  in  the  transaction  file  can  be  displayed 
a  program  to  access  the  file  and  analyze  the  data. 


The  chapter  contains  an  example  of  a  transaction  file  output. 


Chapter  18  -  RSX-1 IN-PLUS  SHADOW  RECORDING 

Shadow  Recording  allows  your  system  to  back  up  all  information  as  it 
is  being  written  to  a  Piles-11  disk.  It  does  so  by  creating  two 
identical  disks  called  a  "shadowed  pair."  More  than  one  pair  of  disks 
may  be  shadowed,  but  shadowed  disk  pairs  cannot  overlap.  The  first 
disk  of  the  pair,  the  primary  disk,  is  the  original  disk  that  exists 
whftther  or  not  Shadow  Recording  is  active.  You  can  make  any  disk  on 
your  system,  including  the  system  disk,  the  primary  disk  of  a  shadowed 
pair. 


Appendix  A  -  Serial  Despooler  (PRT) 

The  Serial  Despooler  Task  (PRT...)  provides  a  means  of  eliminating 
contention  for  the  system  line  printer.  Rather  than  waiting  for  the 
line  printer  to  become  available,  the  task  directs  the  output  intended 
for  the  line  printer  to  a  disk  file.  This  appendix  briefly  describes 
the  Serial  Despoolei  Task  and  documents  Task  Builder  information  for 
it. 


Appendix  B  -  RSX-llM/M-PLUS  UFO  CONVENTIONS 

The  RSX-llM  and  RSX-llM-PLUS  operating  systems  observe  a  set  of  User 
File  Directory  (UFD)  conventions  for  files  on  disk.  These  conventions 
provide  a  uniform  and  consistent  method  of  locating,  allocating,  and 
maintaining  a  file  on  disk.  This  appendix  describes  qroup  and  member 
numbers  and  their  use  in  identifying  the  contents  of  system  UFDs.  A 
section  on  file-naming  conventions  is  also  included. 
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CHAPTER  2 
THE  ACCOUNT  FILE  MAINTENANCE  PROGRAM  (ACNT) 


RSX-1 IM/M-PLUS  provides  an  Account  File  Maintenance  Program  (ACNT)  for 
creating  and  maintaining  an  account  file  on  a  multiuser  system.  The 
account  file  contains  entries  for  all  User  Identification  Codes  (UICs) 
authorized  within  the  multiuser  protection  system.  One  UIC  can  have 
several  users,  each  user  having  his  or  her  password.  When  a  user 
tries  to  log  in,  the  system  checks  the  HELLO  or  LOGIN  command 
parameters  against  the  account  file  to  determine  whether  or  not  the 
user  should  have  access  to  the  system. 


2.1  CONTENTS  OF  THE  ACCOUNT  FILE 

Each  account  in  the  account  file  contains  the  following  information: 

•  UIC  (the  account  number) 

•  Password 

•  User's  default  system  device 

•  First  name 

•  Last  name 

•  User's  Command   Line   Interpreter   (CLI)   if   the   system   has 
multi-CLI  support 

•  Date  and  time  of  the  user's  most  recent  login 

•  The  number  of  times  that  the  user  has  logged  in  to  the  system 

•  Whether  the  user's  terminal  is  to  be  slaved  after  login 

•  On  RSX-llM-PLUS  systems,  a  session  identifier 

•  On  RSX-llM-PLUS  systems,  the  user  account  number 

2.2  INVOKING  ACNT 

Invoke  ACNT,  from  a  privileged  terminal,  as  follows: 

>RUN  SACNT  RET. 
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THE  ACCOUN'I  PILE  MAINTENANCE  PROGRAM  (ACNT) 

ACNT  Identifies  itself  and  displays  a  list  of  options  after   you   type 
the  RUN  command . 

A  nonpr ivileged  user  can  use  ACNT  only  to  modify  the  account  entry  for 
his  or  her  password    (See  the  RSX-llM/M-PLUS  MCR  Operations  Manual) . 


2.3   ACNT  OPTIONS 

ACNT  is  an  interacti-re  program  that  allows  privileged  users  the 
following  options: 

•  (C)  rr-^ate  an  account  file. 

•  (A)     accounts  to  the  file. 

•  (E)  Examlre  individual  account  entries  in  the  file. 

•  (M)  Modify  individual  account  entries  in  the  file. 

•  (L)  List  account  entries  in  the  file. 

•  (D)  Dexete  account  entries  from  the  file. 

•  (S)  Sort  the  account  entries  in  the  file. 

•  (CTRL/Z)  Exit  from  ACNT. 

ACNT  prompts  you  for  an  option.  Enter  one  of  the  letters  indicated  in 
the  parentheses  above.  The  program  responds  by  requesting  further 
input  or  by  displaying  information  for  the  option  you  selected.  The 
remainder  of  this  chapter  discusses  the  ACNT  options  and  includes 
examples  of  each. 

2.3.1   Creating  the  Account  File 

The  Create  option  lets  you  create  the  account  file.  Create  the 
account  file  immediately  after  generating  your  system  to  allow  normal 
use  of  the  system.  The  Create  option  allocates  the  account  file 
(LB: [0,0] RSXll.SYS)  and  sets  the  file  protection  so  that  only 
privileged  users  and  privileged  tasks  can  access  the  account  file. 

You  may  copy  and  optionally  extend  the  account  file  using  the 
Peripheral  Interchange  Program  (PIP)  (see  the  RSX-llM/M-PLUS  Utilities 
Manual) .  The  new  copy  will  have  the  default  file  protection.  You 
should,  therefore,  immediately  run  ACNT.  ACNT  will  detect  the 
incorrect  protection  codes  and  restore  proper  protection. 

The  following  example  shows  how  to  create  the  account  file.  After  you 
invoke  ACNT,  it  responds  with  a  list  of  options  and  a  prompt. 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 

Enter  option:   c  w 

Enter  maximum  number  of  accounts:  35.  liiT) 

Enter  a  decimal  number  (n.)  to  specify  the  maximum  number  of  account 
entries  to  be  listed  in  the  file.  The  system  then  creates  an  account 
file  (LB: [0,0]RSX11.SYS)  large  enough  to  contain  35  accounts. 
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When  the  Create  operation  is  complete,  press  the  ESCAPE  key  to  request 
a  list  of  options.   Then  you  can  a<1d  accounts  to  the  account  file. 


7."^.?     Adding  Account  Entries 

The  Add  option  lets  you  add  accounts  to  the  account  file.  ACNT 
prompts  you  for  the  following: 

•  UIC    (the    account   number). 

•  Password. 

•  User's   default    system   device. 

•  First   name. 

•  Last    name. 

•  User's  CLI.  Tf  your  system  does  not  have  multi-CLI  support, 
ACNT  does  not  prompt  you  for  the  user's  CLI  (MCR  is  the 
default)  . 

•  Whether    the    user's   terminal    is   to    be    slaved    after    login. 

•  On   RSX-llM-PLUS  systems,   a   session   ic'bntifler. 

•  On   RSX-llM-PLUS  systems,   a    user    account   number. 

ACNT  maintains    the    file    in   ascending    order    by   UIC. 

The  prompts  for  the  password,  first  name,  and  last  name  specify  the 
maximum  number  of  characters  that  ACNT  accepts.  The  legal  characters 
for    user    names   and    passwords   are    as    follows: 

•  A   through    Z,    upper-    and    lowercase 

•  0   through   9 

•  •  (apostrophe) 

•  .  (period) 

•  -  (hyphen) 

•  S  (dollar    sign) 

•  I  (exclamation   point) 

The  default  system  device  prompt  requests  a  d3vice  name  and  unit 
number  (optional  if  0).  ACNT  accepts  logical,  physical,  and  pseudo 
device  names.  The  acceptance  of  logical  and  pseudo  device  names  lets 
you  move  the  user  disk  to  another  drive  without  having  to  change  the 
default  device  in  the  account  file.  When  specifying  the  device  name, 
do   not    include   a   colon    (:). 

RSX-llM-PLUS  systems  include  two  additional  prompts:  one  is  for  a 
session  identifier  and  the  other  is  for  the  user  account  number <  The 
session  identifier  and  user  account  number  are  optionally  used  by  the 
Resource  Accounting  Program  (see  Chapter  17).  The  session  identifier 
is  alsc  used  by  the  HELLO  program  (see  the  RSX-llM/M-PLUS  MCR 
Operations  Manual) . 
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The  following  example  shows  how  to  add  entries  to  the  account  file  on 
RSX-llM-PLUS  systems: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 

Enter  option:  A  (fif) 

Enter  account  or  <ESC>  for  options  (  N,N  ):  5,15® 

password  (  <«6  chars.  ) :  A1B2C3  »; 

Default  system  device  (  DDU  ):  UB'HXj 

First  name  (  <»12  chars.  ):  JANE  (MTi 

Last  name  (  <«14  chars.  ):  BARRETT® 

Enter  user  CLI  (default-MCR)  :  OCL  ff^t 

Slave  terminal?  [Y/Nl :  N  m 

Session  ident  (  3  chars.  ):  rec  gr) 

Account  number  (  <"4  digits  ):  117  sPFtl 

UPD  DBl: [005,015] 

In  the  previous  example,  ACNT  creates  an  account  in  the  account  file 
for  Jane  Barrett.  Jane's  password  is  A1B2C3,  her  default  system 
device  Is  DBO:,  her  CLI  is  DCL,  and  her  termincil  is  not  slaved  after 
login.   Jane's  session  identifier  is  REC  and  her  account  number,  117. 

On  an  RSX-llM  system,  this  option  adds  accounts  to  the  account  file  in 
the  same  manner. 

ACNT  remains  in  Add  mode  until  you  press  the  ESCAPE  key  to  request  a 
list  of  options. 


2.3.3   Examining  Account  Entries 

The  Examine  option  displays  two  lines  of  detailed  information  for  each 
account  in  the  account  file.  The  first  line  contains,  from  left  to 
right,  the  following  information: 

UIC 

Password 

First  name 

Last  name 

User's  default  system  device 

On  RSX-llM-PLUS  systems,  a  session  identifier 

The  second  line  contains  the  following  information: 

On  RSX-llM-PLUS  systems,  a  user  account  number. 

Date  of  the  last  login. 

Time  of  the  last  login. 

Number  of  t.'mes  the  user  has  logged  in  to  the  system. 

User's  CLI.   If  your  system  does  not  have  multi-CLI   support, 
ACNT  displays  the  defauli  CLI  (MCR) . 

IVriethcr  the  user's  terminal  is  to  be  slaved  after  login. 
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The  following  example  shows  how  to  display  information  for  an  account 
on  an  RSX-llM  system: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 
L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  E w 

Enter  account  or  <ESC>  for  options  (  N,N  ):  S.MKf 
(005,0141     007        SEAN  CONNOIT  DBG: 

03/05/81   15:05:55    00001   DCL      N 

In  this  example,  Sean  Connoit's  account  is  examined.  The  first  line 
lists  his  UIC  ([005,014]),  password  (007),  first  name,  last  name,  and 
default  system  device  (DBO:).  The  second  line  displays  the  d^te  of 
his  last  login  (03/05/81),  the  time  of  his  last  login  (15:05:55),  the 
number  of  times  he  has  logged  in  (00001)  ,  his  CLI  (DCL) ,  and  the 
slave/no-slave  status  of  his  terminal  (N)  . 

The  following  example  shows  how  to  display  information  for  an  account 
on  an  RSX-llM-PLUS  system: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 
L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  E<RET> 

Enter  account  or  <ESC>  for  options  (  N,N  ):  5,5i«^' 
[005,0051     SKIP       JOHN  MORAN  DBl: 

MGR 
0111     03/06/81   08:36:57    00002   DCL      N 

In  this  example,  John  Moran's  account  is  examined.  His  account 
includes  two  additional  information  fields,  a  session  identifier  (MGR) 
and  a  user  account  number  (0111). 

ACNT  remains  in  Fxanine  mode  until  you  press  the  ESCAPE  key  to  request 
■•  1  ist  of  options. 


?.3.4   Modifying  Account  Entries 

The  Modify  option  allows  you  to  change  the  password,  default  system 
device,  first  name,  and  last  name  for  an  account,  and  the 
slave/no-slave  status  of  a  terminal.  You  can  change  the  CLI  of  an 
account  if  your  system  includes  the  multi-CLI  option. 

In  an  RSX-llM-PLUS  system,  the  Modify  option  also  allows  you  to  change 
the  session  identifier  and  the  account  number. 

After  you  specify  the  account  to  be  modified,  the  prooram  displays  an 
account  entry  and  asks  for  verification.  Type  ei.her  Y  (Yes)  or  N 
(No)  to  indicate  that  the  correct  account  was  or  war  not  specified. 
If  you  specify  N,  ACNT  searches  the  file  for  anot ler  entry  with  the 
same  UIC.  When  you  enter  a  Y,  ACNT  prompts  for  the  entry  details. 
Press  the  ESCAPE  key  if  you  do  not  want  to  change  an  item. 
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Th«  following  oxanpl*  ahows  hor  to  nodlfy  account  infomation  on  an 
HSX-llN  systMit 

>>      options  arat  A  -  ADD,  C  -  CREATE  PILE,  D  -  DELETE,  E  -  EXAMINE, 

?      L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 

I     Bntar  option:  M  liD 

'     Bntar  account  or  <ESC>  for  options  (  N,N  ):  5,12fiD 

[005,012]     BARB       BARBARA       SPENCER  OBOt 

03/05/81   ISiOOill    OOOOfi   MCR      N 

Thia  antry  ?  [Y/N]  :  YfiT 

Typa  <ESC>  to  laava  antry  unchangad 

Password  (  <-fi  chars.  ):  BES  (^ 

Dafault  aystan  davica  (  DDU  ) :  Hg 

First  naaa  (  <>12  chars.  )im 

Last  nana  (  <>14  chars.  ) :  ^ 

Entar  usar  CLI  (dafault-MCR)  :  DCLifi!) 

Slava  tarminal?  [Y/n]'.m> 

In  this  axaaple,  Barbara  Spancar's  account  ia  modi f lad.   Bar   password 
(BARB)  is  changad  to  BES,  and  her  CLI  (MCR)  is  changad  to  DCL. 

The  following  eKample  shows  how  to  modify  account   information  on  an 
RSX-llM-PLUS  system: 

Options  are:  A  ~  ADD,  C  -  CREATE  PILE,  D  -  DELETE,  E  -  EXAMINE, 
L  -  LIST,  M  -  MODIFY,  S  -  CORT,  CTRL/Z  -  EXIT 
Enter  option:  MtfTi 

Enter  asco^nt  or  <ESC>  for  options  (  N,*?  )  :  5,*)  JO 
(005,006]     LI7.        ELIZABETH     PORD  DBls 

SEC 

0112  03/06/81   08:37:47    00001   MCR      N 
This  entry  ?  [Y/N]  :  um 
[005,006]     MLH        MARY  HAZNAR  DBO: 

SEC 

0113  03/06/81   08:38:«5    00001   DCL     N 
This  entry  ?  [Y/N]:  Y  "SD 
Type  <ESC>  to  leave  entry  unchanged 
Password  (  <-6  chars.  ):® 
Default  system  device  (  DDU  )  :  i|^ 
First  name  (  <«12  chars.  ) : f^ 
Last  name  (  <>14  chars.  ) : fgl 
Enter  user  CLI  (default«MCR)  :  fl^ 
Slave  terminal?  [Y/N]  :  Y  «ti 
Session  ident  (  3  chars.  ):  REC  (ST) 
Account  number  (  <«4  digits  ):  116$rri 

In  this  example,  Mary  Haznar's  account  is  modified.   Her   terminal   is 

changed   to  a  slaved  terminal,  her  session  identifier  (SEC)  is  changed  :; 

to  REC,  and  her  account  number  (0113)  is  changed  to  116.  i 

ACNT  remains  in  Modify  mode  until  you  press  the  ESCAPE  key  to   request 
a  list  of  options. 

2.3.5   Listing  Account  Entries  ' 

The  List  option  either  displays  on  the  user's  terminal   or   spools   to 

the   line   printer   all   account   entries   in   the   account   file  or  a  .", 

specified  group  of  entries.   If  you  specify   the   line   printer,   ACNT 

creates    the    file    ACCNT.DMP.    This   file   contains   the   account 

information  you  specified.   ACNT  prints  the  file   if   the   spooler   is 

installed   in   your   system.   If  the  spooler  is  not  installed,  you  may 

print  ACCNT.DMP  after  you  exit  from  ACNT. 
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The  following   example  shows  how  to   list  account  entries  on  an 
RSX-llM-PLUS  system: 

Options  are:  A  -  ADD,  c  -  CREATE  PILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIPY,  S  -  SORT,  CTRL/Z  -  EXIT 

Enter  option;  Lfef} 

Print  passwords?  [Y/N] :  Y  IfD 

All  accounts?  (Y/N]:  N  iSI 

Enter  group  number  (N)  :  5W) 

Enter  T  -  TERMINAL  or  L  -  SPOOLED  LINEPRINTER:  Tiffi) 

[005,005]     SKIP       JOHN  MORAN 

0111  03/06/81   08:36:57    00002   DCL 
[005,006]     LIZ        ELIZABETH     PORD 

0112  03/06/81   08:37:47    00001   MCR 
(005,0061     MLH        MARY  HAZNAR 

0116  03/06/81   08:38:45    00001   DCL 
(005,015]     A1B2C3     JANE  BARRETT 

0117  03/09/81   10:32:53    00001   DCL 

In  the  previous  example,  ACNT  lists  all  the  account  entries,  £or  group 
5,  at  the  terminal. 

On  RSX-llM  systems,  this  option  lists  accounts  in  the  same  manner. 

when  the  list  operation  is  complete,  ACNT  displays   its  options  and 
prompts  for  a  choice. 


2.1.fi   Deleting  Account  Entries 

The  Delete  option  eliminates  individual  accounts  from  the  file.  After 
you  specify  the  account  to  be  deleted,  ACNT  displays  the  account  entry 
and  requests  a  Y  (Yes)  or  N  (No)  response  for  verification.  If  the 
response  is  N,  ACNT  searches  for  another  account  with  the  same  UIC. 
If  the  response  is  Y,  ACNT  asks  if  you  want  to  delete  the  account's 
UFD  and  other  files.  Another  Y  response  deletes  these  files.  If  you 
enter  N  in  response  to  the  deletion  query,  the  account's  files  and  UFD 
are  left  intact. 

The  following  example  shows  how  to  delete  accounts  from  the  account 
file  on  an  RSX-llM  system: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIPY,  S  -  SORT,  CTRL/Z  -  EXIT 

Enter  option:  D® 

Enter  account  or  <ESC>  for  options  (  N,N  ):  5,12® 

[005,012]     MLK        MAUREEN       KACZKA  DBl: 

03/06/81   08:46:51    00004   DCL     N 
This  entry  ?  [Y/N]  :  YWTi 
Delete  UPD  and  files?  (Y/N]:  Y® 
PIP  DBl: (005,012]*.*;*/DE 
>PIP  DBl: (0, 01005012. DIR;*/DE 

In  the  previous  example,  ACNT  deletes  Maureen  Kaczka's  UFD  and  files. 

On  an  RSX-llM-PLUS  system,  this  option  deletes  accounts  in  the  same 
manner. 

ACNT  remains  in  Delete  mode  until  you  press  the  ESCAPE  key  to  request 
a  list  of  options. 
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2.3.7   Sorting  the  Account  Entries 

The  Sort  option  sorts  the  account  entries  in  ascending  order  by  UIC. 
The  following  example  shows  how  to  sort  the  account  file  on 
RSX-llM/M-PLUS  systems: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 
L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  S  «t: 

When  the  sort  operation  is  complete,  ACNT  displays  all  its  options  and 
prompts  for  a  choice. 


2.3.8   Exiting  from  ACNT 

The  Exit  option  allows  you  to  exit  from  the  ACNT  program.  The 
following  example  shows  how  to  exit  from  ACNT  on  RSX-1 IM/M-PLUS 
systems : 

OPTIONS  ARE:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 
L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
ENTER  OPTION:  cxi.'  "(^ 

When  you  exit  from  ACNT,  ACNT  displays  the  following  message  on  your 
terminal : 

OPERATION  COMPLETE 


2.4   ERROR  MESSAGES 

The  ACNT  program  returns  the  following  error  messages: 

ACNT  —  Account  already  exists 

Explanation:  You  attempted  to  add  an  account  with  a  UIC  and 
password  that  already  exists  in  the  account  file. 

ACNT  —  Account  file  already  exists 

Explanation:  You  attempted  to  create  an  account  file  that 
already  exists. 

ACNT  —  Account  file  error 

Explanation:  The  program  detected  an  I/O  error  while 
processing  the  account  file. 

ACNT  —  Account  file  full 

Explanation;  The  account  file  is  full;  you  cannot  add 
further  accounts.  See  the  description  of  the  Create  option 
for  details  on  how  to  enlarge  the  account  file. 

ACNT  —  Cannot  find  account 

Explanation:  You  attempted  to  delete,  examine,  or  modify  an 
account  that  does  not  exist. 
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ACNT  —  Invalid  default  device  name 

Explanation:  The  default  system  device  specified  is  not  a 
directory  device. 

ACNT  —  Warning  **  Device  does  not  exist  on  current  system.    OK? 
[Y/Nl : 

Explanation:   The  specified  default  device   is  not   in  the 

system.    If   you  enter  Y,  ACNT  retains  the  device  name  as  a 

logical  device  name.  ACNT  prompts  again  for  the  device  name 
if  you  enter  N. 

ACNT  —  Invalid  option 

Explanation:  In  response  to  the  prompt  Enter  option:,  you 
did  not  specify  A,  C,  D,  E,  L,  M,  S,  or  CTRL/Z,  which 
represent  valid  ACNT  options. 

ACNT  —  Listing  file  error 

Explanation:  When  you  use  the  List  option,  ACNT  opens  the 
file  SY: [current  uic] ACCNT. DMP.  This  message  indicates  that 
ACNT  cannot  open  the  file;  for  example,  the  device  is  full 
or  it  does  not  contain  a  UFD  for  the  current  UIC.  If  the 
device  is  full,  delete  some  files.  Create  a  new  UFD  if 
there  is  no  UFD  for  the  current  UIC. 

ACNT  —  Syntax  or  command  input  error 

Explanation:  You  typed  an  invalid  character.  Enter  the 
correct  data. 

ACNT  —  Workfile  -  dyn.   mem.   exhausted 

Explanation:  There  is  insufficient  dynamic  memory.  Install 
the  task  in  a  larger  partition,  or  install  it  with  a  larger 
increment . 

ACNT  —  Workfile  -  virtual  storage  exceeded 

Explanation:   The  workfile  exceeds  virtual  memory. 
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CHAPTER  3 
THE  CONSOLE  LOGGER 


The  Console  Logger  consists  of  a  driver  (CODRV)  and  a  task  (COT...) 
that  handle  I/O  to  the  console  output  device  (CO:)  and  record 
time-stamped  system  messages  on  a  terminal  or  in  a  log  file  or  both. 
You  select  support  for  console  logging  in  SYSGEN. 

For  RSX-lIM  systems,  console  logging  is  available  only  on  mapped 
systems. 


3.1   THE  CONSOLE  OUTPUT  DEVICE  (CO:) 

Your  system  has  a  console  output  device  (CO:)  and  a  console  terminal. 
When  the  Console  Logger  is  active,  I/O  to  CO:  is  controlled  by  the 
console  output  task  (COT...)  and  the  console  driver  (CODRV).  When  the 
Console  Logger  is  not  active,  CO:  is  a  pseudo  device,  and  I/O  to  CO: 
is  controlled  by  the  terminal  driver.  In  both  cases,  output  to  CO: 
can  be  forwarded  to  a  terminal  that  you  assign  as  the  console 
terminal . 


3.1.1   CO:  as  a  Pseudo  Device 

When  the  Console  Logger  is  not  active,  CO:  is  a  pseudo  device.  You 
can  redirect  CO:  to  any  terminal  on  your  system  using  the  MCR 
REDIRECT  command.  The  terminal  driver  controls  all  I/O  to  CO:  that 
is  redirected  to  the  console  terminal. 


3.1.2   CO:  with  the  Console  Logger  Active 

When  the  Console  Logger  is  active,  the  console  driver  (CODRV)  and  the 
console  output  task  (COT...)  control  all  I/O  to  CO:.  You  use  a 
console  logging  command  to  assign  the  console  terminal  (see  Section 
3.4.5)  rather  than  redirecting  CO:   with  the  MCR  REDIRECT  command. 

There  are  two  advantages  to  using  the  console  logger  to  control  I/O  to 
CO:.   These  are  as  follows: 

1.  Console  logging  allows  you  to  record  messages  sent  to  CO:  in 
a  log  file.  You  can  record  messages  on  the  console  terminal 
and  in  the  log  file,  only  on  the  console  terminal,  or  only  in 
the  log  file.  This  flexibility  enables  you  to  inspect  the 
log  file  at  any  time  and  to  free  a  termin-'Jl  when  you  do  not 
need  an  on-line  display  of  console  logging. 
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2.  The  console  logger  time-stamps  messages  to  CO:  that  have  not 
been  time-stamped  by  the  task  issuing  the  message  in  the 
form: 

hh;mm:as  hours,  minutes,  and  seconds. 

Also,  prior  to  outputting  the  first  message  after  a  change  of 
date,  the  Console  Logger  outputs  the  current  time  and  date. 


3.2   INSTALLING  COT...  AND  LOADING  CODRV 

If  you  select  console  logging  in  SYSGEN,  SYSGEN  installs  the   console 

output  task  (COT...)  and  loads  the  console  driver  (CODRV)  by  including 

the  appropriate  commands  in  SYSVMR.CMD.    You   only   need  to   install 
COT...  and  load  CODRV  if: 

1.  You  have  removed  one  or  both  of   them   and   want   to   restore 
console  logging. 

2.  You  have  altered  SYSVMR.CMD  to  eliminate  them. 


3.3   COMMUNICATING  WITH  THE  CONSOLE  LOGGER 

You  can  use  the  COT...  task  to  communicate  with   the   Console   Logger. 
Tasks  use  the  CODRV  driver  to  communicate  with  the  Console  Logger. 


3.3.1   User  Communication  with  the  Console  Logger 

COT...  is  a  privileged  task.  From  a  privileged  terminal,  you  issue 
console  logging  commands  to  start  and  stop  console  logging,  assign  the 
console  terminal,  and  specify  the  console  log  file.  Table  3-1 
summarizes  the  console  logging  commands.  There  are  no  DCL  equivalents 
for  the  console  logging  commands.  Section  3.4  discusses  each  console 
logging  command  in  detail. 


3.3.2   Task  Communication  with  the  Console  Logger 

Tasks  communicate  with  the  console  driver   (CODRV)   by   issuing   QIOs 
CODRV   handles   QIOs   to   CO:    for   reading,   writing,  attaching,  and 
detaching.   All  other  I/O  functions  to  CO:   are  passed  to  the  terminal 
driver  as  if  they  were  issued  directly  to  the  console  terminal. 


3.3.2.1   Writing  to.  CO:  -  TasKs   can   issue   QIOs   to  write    system 

messages   to   the   console   terminal   and/or   console  log   file.   For 

example,  HELLO  issues  a  QTO  to  write  a  message  to  the  console  terminal 
each  time  a  user  logs  in  to  the  system. 

Messages  to  CO:  may  begin  with  a  CTRL/G  to  ensure  that  COT...  sends 
the  message  to  the  most  recently  assigned  console  terminal  even  if  you 
have  disabled  the  console  terminal  using  the  NOCOTERM  option 
(discussed  in  Section  3.4.4). 

The  buffer  in  COT...  accepts  messages  not  longer  than  25^5(10)  bytes. 
(Setting  the  buffersize  of  device  CO:  with  the  MCR  SET  /BUFFERSIZE 
command  has  no  affect  on  this  restriction.) 
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Table  3-1 
Summary  of  Console  Logging  Commands 


MCR  Command 

Meaning 

SET 

/COLOG 

Displays  th -^  current 
console  terminal  and 
logfile  assignments. 

SET 

/COLOG=ON 

Starts  console  logging. 

SET 

/COLOG=OFF 

Stops  console  logging. 

SET 

/COLOG/N0C[0TERM] 

Disables  the  console 
terminal . 

SET 

/C0L0G/C0T[ERM1 r=TTnn:l 

Changes  the  console 
terminal  assignment. 

SET 

/COLOG/NOLOGFILE 

Disables  the  logfile. 

SET 

/C0L0G/L0G[FILE1 [=(filespecn 

Changes  the  logfile 
assignment. 

3.3.2.2  Reading  from  CO:  -  Tasks  can  issue  QIOs  to  r?ad  input  from 
the  console  terminal.  For  example,  an  operator  can  use  the  console 
terminal  to  respond  to  prompts  by  a  system  task  that  require  user 
input.  COT...  does  not  record  messages  in  the  log  file  that  are  read 
from  the  console  terminal. 


3.3.2.3  Attaching  and  Detaching  CO:  -  Tasks  may  attach  to  CO:; 
however,  the  attach  is  a  NOP.  Though  tasks  may  attach  or  detach  CO: 
they  are  not  allowed  exclusive  access  to  CO:. 


3.4   COMMAND  DESCRIPTIONS 

You  use  console  logging  commands  to  perform  the  following  functions: 

•  Display  the  current  console  terminal  and  log  file  assignments 

•  Start  and  stop  console  logging 

•  Change  the  console  terminal  and  log  file  assignments 

•  Disable  the  console  terminal  or  the  log  file 
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The  general  format  of  console  logging  commands  In  MCR  is: 

>SET  /COLOGrwCRoptionl... 

t 

SET 

The  MCR  SET  command. 
COLOG 

Console  logging  keyword. 

MCRoption 

One  of  the  console  logging  functions.    You  can   truncate  these 
options  to  three  letters. 

3.4.1  Displaying  the  Current  Console  Terminal  and  Log  File  Assignments 

To  display  the  current  console  terminal  and  log  file  assignments, 
type: 

>SET  /COLOG 

Ust  this  option  to  determine  if  the  Console  Logger  is  active.  When 
the  Console  Logger  is  active,  COT...  displays  the  current  console 
terminal  and/or  log  file  assignments.   For  example: 

>SET  /COLOG 

COT  — 

Console  =  TTOGO: 

Logfiie  =  DBOOO:  [1 ,4]  CONSOLE.  r,OG;  I 

If  the  Console  Logger  is  not  active,  the  display  option  indicates  the 
following : 

COT  — 

Console  =  None 
Logfiie  =  None 

3.4.2  Starting  Console  Logging 

The  following  command  line  starts  console  logging: 

>SET  /COLOG=ON 

When  you  start  console  logging,  COT...  retains  the  current  console 
terminal  assignment.  If  you  have  just  booted  the  system, 
COT...  assigns  CO:  to  TTO:.  The  default  location  and  name  of  the  log 
file  is  LB: [1, 41CONS0LE.LOG.  COT...  always  creates  a  new  version  of 
the  default  log  file  when  you  start  console  logging. 
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3.4. J  Stopping  Console  Logging 

The  following  command  line  stops  console  logging: 

>SET  /COLOG»OFF 

When  you  stop  console  logging,  the  current  console  terminal  assignment 
is  retained.  Use  the  MCR  DEV  command  to  display  the  current  console 
terminal.  Section  3.5  discusses  how  you  can  t'se  the  MCR  DEV  command 
to  monitor  how  CO:   is  redirected. 


NOTE 

Do  not  abort   COT....    Aborting   COT... 
causes  severe  pool  fragmentation. 


3.4.4  Disabling  the  Console  Terminal 

To  disable  the  console  terminal,  type: 

>SET  /COLOG/NOCrOTERMl 

This  command  line  enables  you  to  maintain  a  log  file  of  system 
messages  without  using  a  terminal  as  the  console  terminal.  This  ia 
especially  useful  if  your  system  dor=;  not  have  many  terminals  or  if 
you  cannot  spare  a  terminal  to  dedic  ite  to  receiving  system  messages. 

You  can  disable  the  console  terminal  by  assigning  the  console  terminal 
to  the  null  device  (NL:). 

Once  you  have  disabled  the  console  terminal  with  the  NOCOTERM  option, 
the  command 

>SET  /COLOG/COTERM 

restores  the  most  recent  console  terminal  assignment. 


3.4.5  Reassigning  the  Console  Terminal 

The  following  command  line  reassigns  the  console  terminal: 

>SET  /COLOG/COT[ERMH=TTnn:l 

where  TTnn:  is  the  newly  assigned  console  terminal.  When  you  boot 
your  system,  the  default  console  terminal  assignment  is  TTO:.  When 
you  start  console  logging,  the  default  console  terminal  assignment  is 
the  current  console  terminal. 


3.4,6  Disabling  the  Log  Pile 

To  disable  the  log  file,  type: 

>SET  /COLOG/NOLOGFILE 

This  command  line  enables  you  to  continue  recording  system  messages 
time-stamped  by  COT...  at  the  console  terminal  without  recording  the 
messages  in  a  log  file. 
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3.4.7  Reassigning  the  Log  Pile 

The  following  command  line  reassigns  the  log  file: 
>SET  /C0L0G/L0G[F1LE] [-[f ilespecl 1 

where  filespec  is  any  legal  file  specification  as  described  in  the 
RSX-llM/M-PLUS  Utilities  Manual.  The  default  filespec  is 
LB: [1,4 1C0NS0LE.LOG. 

To  change  only  part  of  the  log  file  filespec,  type  only  that   part   of 

the   filespec  after   the   equal   sign   that  you  want  to  change.   For 

example,  if  LB:  is  DRO:  and  you  want  to  make  the  log  file 
DBO: [301, 551CONSOLE.LOG,  type: 

>SET  /COLOG/LOGFTLE-DBO: [301,5S1 

If  you  want  to  make  the  log  file  TESTL0G.LOG  in  the  default  UIC  on 
LB:,  type 

>SET  /COLOG/LOGFILE-TERTLOG 

In  all  cases,  COT  fills  in  the  missing  parts  of  the  filespec  with 
parts  from  the  default  filespec,  LB: [ 1 , 41C0NS0LE.LOG,  and  creates  a 
new  version  of  the  log  file. 

To  create  a  new  version  of  the  current  log  file,  type: 

>SET  /COLOG/LOGFILE= 

If  you  have  disabled  the  log  file  with  the  NOLOGFILE  option,  this 
command  line  restores  the  most  recent  log  file  assignment.  Although  a 
new  version  of  the  log  file  is  created,  the  rest  of  the  filespec  does 
not  change. 

To  change  the  log  file  back  to  the  default,  type: 

>SET  /COLOG/LOGFILE 

This  command  line  creates  and  opens  a  new  version  of  the  default  log 
file. 


3.4.8   Using  Multiple  Console  Logging  Commands 

You  can  use  multiple  console  logging  commands  in  a  command  line.  The 
following  command  line  starts  console  logging,  assigns  the  console 
terminal  to  TT17:,  and  opens  a  log  file  named  TESTLOG.TST  in  the 
default  UFD  on  LB: 

>SET  /C0L0G=0N/C0TERM=TT17:/L0GFTLE=TESTL0G.TST 

The  following  command  line  disables  the  console  terminal  and  restores 
the  log  file  to  the  default: 

>SET  /COLOG/NOCOTERM/LOGFILE 
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3.5   MONITORING  THE  STATUS  OF  CO: 

To  use  the  MCR  DFV  command  to  determine  the  status  of  CO:,  while  the 
console  logger  is  active,  enter: 

>DEV  CO: 

The  system  responds: 

COO:   LOADED 

This  response  means  that  the  console  driver  (CODRV)  is  loaded  and  that 
COT...   handles  system  messages  to  CO:. 

Use  the  console  logging  display  option  to  display  the  console  terminal 
assignment : 

>SET  /COLOG 

If  you  have  disabled  console  logging,  use  the  MCR  DEV  command  to 
determine  the  terminal  assigned  as  CO: 

>df:v  rO: 
COO:   TTnn: 

where  nn  is  the  terminal  to  which  the  CO:  pseudo  device  is 
redirected . 

Before  COT...  exits,  it  redirects  CO:  to  the  current  console 
terminal.  If  there  is  no  console  terminal  (because  you  disabled  it 
with  the  NOCOTERM  option)  when  you  stopped  console  logging,  then  CO: 
is  redirected  to  the  last  terminal  COT...  assigned  as  the  console 
terminal.  In  this  case,  the  terminal  driver  handles  messages  directed 
to  CO:   and  redirects  them  to  TTnn:. 

If  you  have  disabled  the  console  terminal  with  the  NOCOTERM  option  but 
continue  to  record  system  messages  to  CO:  in  a  log  file,  then  use  the 
MCR  DEV  command  to  determine  the  status  of  CO: 

> DEV  CO: 
COO:   LOADED 

This  response  means  that  the  console  driver  is  loaded  and  that 
COT...  handles  all  messages  directed  to  CO:;  however,  system  messages 
are  not  directed  to  a  terminal.  Use  the  display  option  to  verify  that 
CO:   is  not  assigned  to  a  terminal. 


3. a      REDIRECTING  CO:  WITH  THE  MCR  REDIRECT  COMMAND 

Use  the  MCR  REDIRECT  command  to  redirect  CO:   to  a  terminal  only  when 

the  console   logger  is  not  active.   If  you  try  to  redirect  CO:  while 

the  console  logger  is  active,  you  will   receive   the   following  error 
message : 

>RED  —  Device  not  redirectable 
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For  example.  If  the  Console  Logger  is  active,  the  console  terminal  is 

assigned   to   TT2:,  and  you  stop  console  logging,  COT...  redirects  CO: 

to  TT2:   before  exiting.   Use  the  MCR  DEV  command  to  verify   that  CO: 

is   redirected   to   TT2:.   To  assign  the  console  terminal  to  TTO:  use 
the  MCR  REDIRECT  command: 

>RED  TTO: -CO: 

If  you  then  start  console  logging  again,  COT...  will  assign  TTO:    as 
the  console  terminal. 


NOTE 
Do  not  redirect  CO:  to  CO:. 

3.7  READING  THE  LOG  FILE 

Because  the  current  log  file  is  open  for  writing  if  LOGFILE  is 
enabled,  you  can  read  it  only  by  using  PIP  with  the  Shared  Read  (/SR) 
switch.  For  example,  if  the  log  file  is  DRO: [ 1 , 4]C0NS0LE. LOG,  and  you 
type 

>PIP  TI :«DRO: [1,4 1C0NS0LE.LOG 
PIP  responds: 

PIP  —  Open  failure  on  input  file 

DRO: [1,41C0NS0LE.L0G;1  —  Accessed  for  write 

To  read  the  log  file,  type: 

>PIP  TI:«DRO: [l,4]C0NS0LE.L0G/SR 

A  sample  log  file  follows: 

16:43:19  Logout  user  [1,41  TT53: 

1*^:43:35  Login   user  ALPHA  [7,3341  TT53: 

16:45:07  Login   user  BRAVO  [7,421  TT13: 

16:46:21  ***  DMO:  —  DISMOUNT  COMPLETE 

16:46:32  Login   user  DECNET         [240,240]  TT30: 

16:47:22  Login   user  CHARLIE        [7,373]  TT22: 

16:47:38  ***  LPO:  —  NOT  READY 

16:47:49  Logout  user  [1,4]  TT53: 

16:47:5B  Logout  user  [7,373]  TT22: 

16:48:01  Login   user  ALPHA  [7,334]  TT53: 

16:49:40  Login   user  DECNET         [240,240]  HTO: 

3.8  SAMPLE  CONSOLE  LOGGING  TERMINAL  SESSION 

Example  3-1  shows  a  console  logging  terminal  session  illustrating  hew 
you  use  all  the  commands  described  in  the  previous  Sections  3.4 
through  3.7. 
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Example  3-1   Sample  Console  Logging  Terminal  Session 
(This  example  assumes  that  LB:  is  assigned  to  DBO:.) 


>SET  /COLOG 
COT  -- 

Console  ■  Non* 
Loafile  =    None 
DEV  co: 
COOJ  TTO: 
>SET  /COLOG=ON 

>DEv  co: 

coo:  LOADED 

>SET  /COLOG 

COT  -- 

Console  «  TTOOO: 

Loflfile  >  DDOOO:C 

>SET  /COLOG/COTER 

>SET  /C0L06/L0GFI 

:>SET  /COLOG 

COT  -- 

Console  ^    TTOSi: 

LoAfile  =    DR000:[301iS53TEST.L0G$l 

>SET  /COLOG/KOCOT 

>SET  /COLOG 

COT  -- 

Console  =  Noni 

Loafile  =  DF;000:C301.55DTEST.L0GU 

>Dev  co: 

coo:  LOADED 

>SET  /COLOG/COTER/NCLOG 

>SET  /COLOG 

COT  -- 

Console  =  TT051 

Lodfile  "    None: 

>SET  /C0L0G/C0TERM=TT17:/L0G= 

>SET  /COLOG 

COT  -- 

Console  =  TT017: 

Losfile  =  DROOO:C301fS53TEST.LOG82 

>SET  /COL0G=OFF 

>SET  /COLOG 

COT  -- 

Console  ^  None 

Lorifile  =  None 

>DEV  co: 

TT17: 
TT5i:=C0t 

co: 

TT511: 

/COLOG=CN/L03=DBi:C7»301] 

/COLOG 


coo: 

>RED 
>DEV 

coo: 

>SET 

>SET 

COT  -- 

Consoie  »  TT051; 

Lo«file  -  DD00i:c 

>SET  /C0LOG/COT=T 

>SET  /COLOG 

COT  -~ 

Console  =  TTOOO: 

Logfile  "    DBOOO?C 


7>301]C0NS0LE.L00n 
T0:/L0G 


lf4]C0NS0LE.L0Q)3 


o 

CD 

)  ® 
<D 


(continuerl  on  next  page) 
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Example  l-l  (Cont.)   Sample  Console  Logging  Terminal  Session 


>Plf 

PIP  - 

DBO:C 

>PIf 

16:43 

16:43 

16:4S 

16:46 

i<.:46 

16:47 

16:47 

16:47 

16:47 

16:46 

16:49 

>SET 

COT  - 

>DEV 

cuo: 


Ti:-LEi:  t  1  t41C0NS0LE  .LOG 

-    Open    fail>jre    on    inMjt    file 

If 43CONSOLE.LOG t 3    --    Accessed 

Tl:«L»:t  1  .4  3C()NSOLt  .LOG/SR 


for  write 


) 


:i9 
:3S 
:o7 
:2i 
:32 

'.22 

:38 

:49 
:58 
:oi 
:40 


Loaoui  user 
Loam  ij«er 
Loflin  user 
««t  DHO:  -- 
Loiin  user 
Loflin  user 
99$  LPO:  -- 
Loflout  us7r 
Loaout  user 
Loain  user 
Loain  user 


DECNCT 
CHARLIC 
NOT  READY 
CI. 43  TTb3: 
t7.373D  TT22: 
ALPHA 
DECNET 

/COi-OG/HOCOIERHNOl  OG 

-  Not  loaaina  on  •  ierikiri»l  or 

co: 

TTO: 


[1.43  TT53: 

ALPHA  C7.334)  TT53: 

BRAVO  C7.42]  TT13: 

DISnOUNT  COMPLETE 

i:240.240J  TT30: 
C7.3733  TT22: 


>• 


£7.3343  TT?3: 
C240.2403  MTO: 

lo  •  file.  rOT  exiiina 


Displays  the  current  console  terminal  (none)  and  log  file 
(none)  assignments  indicating  that  the  Console  Logger  is  not 
active. 

Illustrates  the  ^CR  DEV  command  that  showr  how  CO:  is 
redirected.  CO:  is  redirected  to  TTO:,  which  means  that 
the  Console  Logger  is  not  /ctivo  and  that  the  terminal 
driver  redirects  CH:   to  TTO:. 

Starts  console  loiiging. 

Shows  that  the  Console  Logger  is  active  because  CODRV  Is 
loaded.  The  display  option  shows  that  COT...  redirects  CO: 
to  TTO:  and  that  DBO: r i . 41  CONSOLE. LOG; 1  is  the  log  file. 
These  are  both  the  defaults  when  you  boot  your  system. 

Shows  how  you  assign  the  console  terminal  to  TT51:. 

Shows  how  you  assign  the  log  file  to  OR: f 301 , 55] TEST. LOG. 
COT...  fills  in  the  missing  parts  of  the  fllespec  with 
parts  from  the  default  filespec.  In  this  case, 
COT...  supplies  the  file  type. 

Displays  the  current  console  terminal  (TT51 : )  and  log  file 
(DR: f 301 , 551TEST.LOG; 1 )  assignments  resulting  from  command 
lines  5  and  ^. 


Disables  the  console  terminal  and  retains  the  current  log 
file  (OR: [301, 55) TEST. LOG; I) .  The  display  option  confirms 
this. 

Shows  that  when  you  disable  the  console  terminal  with  the 
NOCOTERM  option,  the  console  logger  is  still  active  (CODRV 
is  loaded),  but  CO:   is  not  redirected  to  any  terminal. 

Illustrates  the  multiple  commands  that  restore  the  most 
recent  console  terminal  assignment  (TT51:)  and  disable  the 
log  fils.   The  ilsplcy  option  confirms  this. 
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0  Illustrates  the  multiple  commands  that  assign  the  console 
terminal  to  TTl?:  and  restore  the  most  recent  log  file. 
The  display  option  confirms  these  assignir->nts.  The  log  file 
version  number  increments. 

^  Stops  console  logging.  The  display  option  confirms  that  the 
console  logger  is  not  active.  CO:  is  redirected  to  TT17:, 
which  was  the  last  console  terminal  assignment  before 
COT. . .  exited . 

<D  Redirects  CO:  to  TT51:  with  the  MCR  REDIRECT  command  and 
confirms  this  with  the  MCR  DEV  command. 

0   Illustrates  multiple  commands  on   a   command   line.    Starts 

console   logging,   retaining  the   current   console  terminal 

assignment  (TT51:)  redirected  with  the  MCR  REDIRECT   command 

in     step     13,      and  opening     a     log     file 

DBOOli f 7, 3011CONSOLE.LOG; 1 .  The   display   option   confirms 
these  assignments. 

Q  Illustrates  multiple  commands  on  a  command  line.  Assigns 
the  console  terminal  to  TTO:  and  restores  the  default  log 
file.  The  display  option  confirms  tnese  assignments.  The 
versic 1  number  of  the  log  file  incr«ments. 

^  Illustrates  what  happens  when  you  try  to  read  an  r;pen  log 
file  without  the  Shared  Read  switch  (/sr*)  . 

^  Shows  how  to  read  an  open  log  file  using  the  Shared  Read 
switch.  Each  message  in  the  log  file  begins  with  a  time 
stamp. 

^  Disables  the  console  terminal  and  the  log  file. 
COT...  exits  because  no  console  logging  is  in  progress. 
COT...  displays  a  message  informing  you  that  it  is  exiting. 
The  MCR  DEV  command  shows  that  CO:  is  recMrected  to  TTO:, 
the  console  terminal  assignment  before  COT...  exited. 


3.9   ERROR  MESSAGES 

COT  —  LUN  assignment  to  console  terminal  failed 

Explanation:   You  specified  an  incorrect  terminal  number   as  the 
console  terminal. 

User  Action:   Use   the   COTERM   option   to   assign   the    console 
terminal  to  a  terminal  in  your  hardware  configuration. 

COT  —  Illegal  console  terminal 

Explanation:   You  tried  to  assign  a  device  that  is  off  line  or  is 
not  a  terminal  to  CO:. 

On  RSX-llM-PLUS  systems,  the  device  nay  be  illegal  because  it  ia 
a  spooled  terninal. 

User  Action:   Use  the  COTERM  option  to  assign  a  terminal  in  your 
hardware  configuration  to  CO: 
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COT  —  Console  driver  not  loaded,  COT  exiting 

Explanation:   The  console  driver,  CODRV,  is  not  loaded. 

User  Action:   Load  the  console  driver  and  start  console  logging. 

COT  —  Maximum  consecutive  write  errors,  disabling  logfile 

Explanation:  An  error  occurred  on  five  consecutive  write 
operations  to  the  log  file.  COT...  closes  the  log  file  and 
disables  logging  to  the  log  file. 

User  Action:  Determine  the  problem  that  causel  the  write  errors 
and  correct  it.   Then  restart  COT... 

COT  —  Not  logging  on  a  terminal  or  to  a  file,  COT  exiting 

Explanation:  You  have  disabled  the  console  terminal  with  the 
NOCOTERM  option  and  the  log  file  with  the  NOLOGPILE  option. 

User  Action:  If  you  did  not  intend  to  stop  consol  <  logging, 
start  it  again  specifying  either  a  log  file,  console  terminal,  or 
both. 

COT  —  Unable  to  redirect  CO:   to  a  terminal  -  CO:   is  offline,  COT  exiting 

Explanation:  CO:  is  off  line.  There  is  a  problem  with  the  most 
recent  console  terminal  assignment.  It  may  be  off  line  or  not  a 
terminal . 

On  RSX-llM-PLUS  syatAMS,  th*  probl««  nay  be  that  a  spoolad 
taminal  was  assignsd. 

User  Action:  Start  COT...  and  specify  a  legal  console  terminal 
with  the  COTERM  option.   Then  stop  console  logging. 

COT  —  Syntax  error 

Explanation:  You  made  an  error  in  entering  a  console  logging 
command . 

User  Action:  Check  the  command  description  in  Section  3.4,  and 
enter  the  command  correctly. 

COT  —  Will  attempt  console  LUN  assignment  to  TTnn: 

Explanation:  This  error  message  may  occur  when  you  stop  console 
logging.  If  COT...  cannot  redirect  the  console  terminal  to  the 
terminal  currently  assigned  as  the  console  terminal,  it  tries  to 
redirect  CO:  to  the  previous  console  termi.ial  assignment.  If 
that  fails,  it  tries  TTOr.  If  that  fails,  it  generates  the  error 
message: 

SCOT  —  LUN  assignment  to  console  terminal  failed 

User  Action:  Start  console  logging  again,  specifying  a  legal 
console  terminal.   Then  stop  console  logging. 
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COT  —  Illegnl  command  -  Consols  logging  has  not  been  turned  on 

Explanation:  You  issued  a  console  logging  command  before 
starting  console  logging. 

Ua«r  Action:   Start  console  logging  and  issue  the  command. 

COT  —  Logflle  x  error 

filespec  —  Qio  Error  Code  -nn. 

Explanation:  An  T/0  error  occurred  while  COT...  was  performing 
an  operation  on  the  log  file.  The  function  being  performed,  x, 
is  WRITE,  OPEN,  or  CLOSE.  The  filespec  is  any  legal  filespec 
designated  for  the  log  file.  The  error  code,  -nn.,  is  an  I/O 
Error  Code  described  in  the  IAS/RSX-11  I/O  Operations  Reference 
Manual . 

User  Action:  Look  up  the  I/O  Error  Code  in  the  lAS/RSX-U  I/O 
Operations  Reference  Manual  and  take  the  appropriate  action.   
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CHAPTER  4 
THE  I/O  EXERCISER  (lOX) 


The  I/O  Exerciser  (lOX)  detects  and  diagnoses  I/O  problems  on  the  disk 
and  tape  units  in  your  hardware  configuration.  Using  the  lOX  Command 
Language,  you  can  execute,  control,  and  monitor  I/O  exercises  on 
device  units  that  you  specify  for  exercising. 

This  chapter  has  a  narrative  part  and  a  reference  part.  The  narrative 
part  presents  the  information  you  need  to  run  the  I/O  Exerciser  in  the 
order  you  need  that  information.  The  reference  part  describes  each 
command  in  the  lOX  Command  Language. 


4.1   INTRODUCTION 

This  section  serves  the  following  functions: 

•  Provides  an  overview  of  the  steps  Involved  in  running  an   I/O 
exercise 

•  Describes  how  the  I/O  Exerciser  exercises  different   types  of 
devices 

•  Distinguishes  between  file-structured   and   nonf 1 le-structured 
volumes 

•  Categorizes  the  lOX  commands  by  function 


4.1.1  Overview  of  the  Steps  Involved  in  Running  an  I/O  Exercise 

Before  you  run  an  I/O  exercise,  you  need  to  consider  the  following: 

•  Kinds  of  devices  to  exercise  (magnetic  tapes,  cassettes, 
disks,  and  DECtapes) 

•  Kind  of  exercise  to  run  for  each  device  (lOX  has  three  kinds 
of  exercises) 

•  Exercise  parameters  to  set  for  each  exercise  (such  as  whether 
or  not  to  test  random  blocks  on  disks,  how  many  records  to 
test  on  magnetic  tapes,  and  how  long  to  run  the  exercise) 

The  steps  involved  In  running  an  I/O  exercise  Include  your  making 
decisions  about  these  three  aspects  of  testing.  Using  the  lOX  Command 
Language,  you  Implement  these  decisions  and  run  an  exercise. 
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Running  an  I/O  exercise  consists  of  the  following  basic  steps: 

1.  Invoke  lOX. 

2.  Determine  which  devices  you  want  to  test  and  include  them   in 
your  "test  configuration." 

3.  Determine  the  kind  of  exercise  to  run  on  each   unit   in  your 
test  configuration. 

4.  Set  exercise  parameters  to  affect  how  lOX  tests  the  units  you 
want  to  exercise. 

5.  Begin  the  exercise  and  possibly   interrupt   the  exercise   to 
change  steps  2,  3,  and  4. 

ft.      Monitor  the  activity  and  error   reports   that   lOX  generates 
during  an  exercise. 

7.   Exit  lOX  or  repeat  this  process  beginning  at  step  2,    2,    A,   or 
S  as  appropriate. 


4.1.2  How  lOX  Exercises  Different  Types  of  Devices 

lOX  performs  lOX  exercising  on  disks,  magnetic  tapes,  cassettes,  and 
DECtapes.  You  can  use  lOX  to  exercise  any  disk  or  tape  unit  in  your 
hardware  configuration  that  has  a  mounted  volume  and  is  not  allocated 
to  another  user.  By  default,  lOX  can  exercise  28  units 
simultaneously.  You  can  edit  the  task  build  cotimand  file  (see  Section 
4.11)  to  enable  lOX  to  test  as  many  as  250  units  simultaneously. 

In  general,  I/O  exercises  consist  of  four  steps: 

1.  Writing  1024.   bytes  of  data  made   up  of   a   specific  data 
pattern  to  a  mounted  volume 

2.  Reading  the  data  just  written 

3.  Checking  that  the  data  read  matches  the  data  written 

4.  Reporting  mismatches  of  data 

lOX  repeats  this  process  until  the  exercise  has  completed. 


4.1.2.1  How  lOX  Exercises  Disks  -  lOX  writes  a  ouffer  of  data  to  a 
disk  and  then  reads  that  data  from  the  disk.  You  can  set  exercise 
parameters  that  determine:  the  data  pattern  to  be  written,  the  range 
of  blocks  to  be  tested,  and  whether  to  test  blocks  sequentially  or 
randomly. 


4.1.2.2  How  lOX  Exercises  Magnetic  Tapes  and  Cassettes  -  lOX  uses  the 
same  algorithm  to  exercise  magnetic  tapes  and  cassettes.  lOX  rewinds 
the  tape,  writes  one  record,  space  reverses  one  record,  and  then  reads 
the  record  that  was  just  written.  This  repeats  until  the  number  of 
records  that  you  specified  for  testing  are  read.  At  the  end  of  the 
exercise,  TOX  writes  two  tape  marks  and  rewinds  the  tape.  If  you  are 
testing  more  than  one  unit,  lOX  continues  testing  on  those  units  while 
the  tape  is  rewinding.  You  can  set  exercise  parameters  that 
determine:  the  data  pattern  to  be  written,  the  size  of  the  data 
buffer,  and  the  number  of  records  to  be  exercised. 
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4.1.2.3  ■•»  lOZ  Bi«rcis«a  DKtap«s  -  lOX  exarcisac  DECtapaa  by 
writing  forward/raadlng  forward,  than  writing  ravaraa/raading  ravarae 
until  tha  and  of  the  tapa  ia  raachad.  lOX  axarciaaa  DECtapaa  uaing  a 
data  buffar  of  two  blocka  (1024.  bytaa) .  You  can  aet  «  teat 
parameter  only  to  daterroine  the  data  pattern  that  lOX  writea  to  tha 
DECtapa . 


4.1.2.4  Monf ila-8tractored  and  Fila-Structurad  voluaaa  -  lOX  exer- 
ciaea  devicea  with  two  kinds  of  volumes:  nonf ile-structured  (NFS)  and 
file-structured  (Files-ll).  The  meanings  of  these  terms  may  differ 
slightly  from  other  manuals  within  the  RSX-llM/M-FLUS  set.  In  the 
context  of  the  I/O  Exerciser,  they  are  defined  as  follows.  All  tapes 
are  NFS  volumea.  (Throughout  this  chapter,  the  term  "NFS"  describes 
devices  and  the  testing  of  devices  that  contain  nonf ile-structured 
volumes.)  Disks  can  be  either  NFS  or  Files-ll  volumes.  Files-ll 
volumes  are  only  those  disks  that  have  been  initialized  with  the  MCR 
INITIALIZE  command  and  therefore  have  a  home  block  and  a  Files-ll 
structure. 


4.1.3  Thf>  Foar  Catagorias  of  lOX  Coamanda 

The  lOX  Command  Language  has  four  categories  of  commands: 

Function  Commands  '_  i^ 

Select  devices  for  testing,  deselect  devices  from  testing,  and 
initiate  tasks  to  run  in  parallel  with  lOX. 

Control  Commands 

Start  and  stop  lOX  processing,  switch  lOX  modes  of  operation,  and 
exit  from  lOX  to  the  operating  system  monitor. 

Display  Commands 

Display  current  default  parameters,  get  help  text  ''or  lOX 
commands,  and  display  <*tatus  and  activity  reports  during  an  I/O 
exercise. 

Parameter  Commands 

Set  default  parameters  that  affect  how  lOX  tests  the  devices  you 
select  for  testing. 

Table  4-1  lists  the  lOX  commands  under  their  appropriate  categories. 
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Tabl*  4-1 
Pour  Cat«gori«s  of  lOX  Commands 


Function 

Control 

Display 

Parameter 

DESELECT 

ABORT 

BADBLOCRS^ 

BADBLOCKS^ 

EXECUTE 

CTRL/C 

CONFIGURE  1 

BUFPERSIZE 

PILE811 

EXIT 

dehsityI 

COMPAREDATA 

SELECT 

PROCEED 

HELP 

CONFIGURE  1 

VEKIPY 

RESTART 

PARAHBTERLIST 

CONTROL_C 

START 

pattern! 

density! 

PRINTSUMMARY 

ERRORLIMIT 

RANGE  1 

interleave 

SPY 

LOGFILE 

pattern! 

RANDOM 

1 

RANGE  1 

RECORDS 

reporterrors 

retries 

RUNTIME 

SUMMARYTIME 

TEMPORARYFILE 

I 

VOLUMECHECK 

WAIT 
WRITECHECK 

1.  These  commands  have  two  forms:  one  that  displays  the 
current  default  for  the  parameter  and  one  that  sets  the 
current  default  for  the  parameter. 


4.2   IHSTALLIMG  AMD  INVOKING  lOZ 

lOX  is  task  built  as  a  nonprivileged ,  checkpointable  task  that  runs  at 
a  priority  of  50  in  the  GlN  partition.  You  can  run  lOX  by  using  the 
NCR  or  3CL  RUN  command  or  by  installing  and  invoking  lOX. 


4.2.1   Installin<3  lOX 

Install  lOX  from  a  privileged  terminal  with  the  MCR  or  DCL  INSTALL 
command • 

Foe  R8X-11M  systems  that  do  not  support  the  Extend  Task  Directive  (see 
the  R8X-11W/M-PLUS  Executive  Reference  Manual),  install  lOX  with  an 
increSiht  large  enougH  Eo  accommodate  aTI  Buffers.  Assuming  all 
initial  lOX  defaults,  allocate  600.  words  per  unit  to  be  tested 
simultaneously.  For  exaihple,  to  test  three  devices  simultaneously, 
install  lOX  as  follows: 

>INS  $IOX/INC='1800. 

For  RSX-llM  systems  that  support  the  Extend  Task  Directive,  install 
lOX  without  an  increment. 

Por  RSX-llM-PLOS  OYsteas,  install  lOX  by  typinc: 
>tNS  $IOX 
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4.2.2   Invoking  lOX 

Tou  can  invoke  lOX  from  any  terminal. 

On  R8X-11M  single  user  systema,  mount  all  disks  that  you  want  to 
exercise  as  file-structured  disks.  If  you  have  a  multiuser  systea^ 
first  allocate  all  units  that  you  want  to  exercise.  Then  mount  only 
those  disks  that  you  want  to  exercise  as  file-structured  disks. 

On  1I8X-11M-K.08  systems,  allocate  and  mount  all  units  thrt  you  want  to 
exercise.  Mount  nonfile-structured  volumes  using  the  /rORBIGM  switch 
Coc  the  MOONT  coamand. 


iOX   is   installed. 


4.2.2.1   Invoking  an  Installed  Version  of  IOX  -  If 
invoke  it  with  the  command: 

>IOX 
IOX> 

IOX  responds  by  prompting  you  with  the  name  of  the  task  that  vou 
assigned  to  IOX  when  you  installed  it.  If  you  did  not  specify  a  ask 
name  when  you  insi-.&Iled  IOX,  its  task  name  is  ...IOX.  \fter  receiving 
the  prompt,  you  can  enter  IOX  commands. 


4.2.2.2  Invoking  IOX  When  It  Is  Not  Installed  -  i.  IOX  is  not 
installed,  invoke  it  with  the  MCR  or  DCL  RUN  command  ,  In  this  case, 
IOX  uses  your  terminal  number  to  name  the  task  and  prompts  you  using 
this  task  name.   For  example,  if  from  TTIO:   you  type 

>RUN  $IOX 
you  will  be  prompted: 

TT10> 

When  you  receive  this  prompt,  you  can  enter  IOX  commands. 

For  RSX-lIM  systems,  if  your  system  does  not  support  the  Extend  Task 
Directive,  then  run  the  I/O  Exerciser  with  an  increment  large  enough 
to  accommodate  all  buffers.  Assuming  all  initial  IOX  defaults, 
allocate  600.  words  per  device  to  be  tested  simultaneously.  For 
exauBple,  to  test  four  devices  simultaneously,  invoke  IOX  as  follows: 

>RUN  $IOX/INC=240C. 

When  you  invoke  an  uninstalled  version  of  IOX  on  RSX-llM  systems  that 
support  the  Extend  Task  Directive,  you  do  not  need  to  run  the  task 
with  an  increment. 

iMien  you  invoke  an  uninstalled  version  of  IOX  on  RSX-llM-PLOS  systems, 
you  do  not  need  to  run  the  task  with  an  increment. 
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4.3   08IMG  imilCT  COmUMD  riLBS  WITH  lOX 

You  can  us*  indirect  command  files  as  input  to  lOX.  lOX  accepts  one 
level  of  indirect  command  files.  You  can  use  indirect  command  files 
to  set  up  your  test  configuration,  choose  devices  for  testing,  set 
exercise  parameters,  and  start  and  exit  the  exercise.  You  cannot 
interrupt  an  I/O  exercise  to  enter  lOX  commands  from  an  indirect 
command  file.   The  default  file  type  is  "CMD." 


For  example,  use  an  editor   to  create  a   file 
contains  the  following  lOX  command  sequence: 


named   TEST. CMD   that 


CONFIGURE  DB2: 
FILBSll  DB2: 

RUNTIME  10 

START 
EXIT 


Adds  DB2:  to  the  test  configuration. 

Chooses  DB2:  for  an  exercise  that  preserves 
the  contents  and  structure  of  the  disk. 

Sets  an  exercise  parameter  that  runs 
for  10  minutes. 

Starts  the  exercise. 

Exits  from  lOX  to  the  operating  system 
monitor  when  the  exercise  completes. 


After  you  invoke  lOX,  type: 

IOX>gTEST 

lOX  exercises  DB2:   (preserving  its  contents   and   structure) 
minutes  and  then  exits  to  the  operating  system  monitor. 


for   10 


4.4   SETTIHir;  OP  YOOR  TEST  COMFIGDRATION 

Before  you  can  exercise  a  unit,  you  must  first  include  it  in  your  test 
configuration.  When  you  include  a  unit  in  your  test  configuration, 
lOX  adds  the  unit  to  its  list  of  units  available  for  exercising  and 
creates  an  empty  data  structure  for  the  unit.  lOX  includes  in  the 
default  test  configuration  one  of  each  device  type  supported  by 
DIGITAL  as  unit  "0". 

To  add  units  to  the  test  configuration,  you  >jse  the  CONFIGURE  command. 
The  syntax  for  this  command  is 


CONFIGURE  [ddnn:  I«type) 1 


where 


dd 


nn 


Device  mnemonic 


Device  number 


type 

Device  type.   Either  DISK  or  TAPE. 

You  can  add  any  unit  to  the  test  configuration  and   assign 
device  name  to  it  by  using  the  NCR  ASN  (ASSIGN)  command. 


a   logical 
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Tha  CONFIGURE  command  with  no  arguments  displays  the  current  test 
configuration.   For  example: 

IOX>CONFIGURE 

Disks : 

DBO   DDO   DFO   DKO   DLO   DM0   DPO   DRO   DSO   DUO 

DXO   DYO   EMO   SYO 

Ta  pe  s : 

CTO   DTO   MFO   MMO   MSO   MTO 

To  add  DKl:   and  MMl:   to  your  configuration,  type: 

IOX>CONFIGURE  DKl:   HMl : 

This  command  line  adds  DKl:  to  the  configuration  as  a  disk  unit 
(because  DKO;  is  already  configured  as  a  disk)  and  MMl:  to  the 
configuration  as  a  tape  unit  (because  MMO:  is  already  configured  as  a 
tape).   Section  4.12  describes  the  CONFIGURE  command  in  detail. 


4.5   SELECTING  DEVICES  FOR  EXERCISING 

After  having  configured  all  the  units  you  want  to  exercise,  you  select 
units  for  exercising.  When  you  select  a  unit,  lOX  fills  in  the  data 
structure  created  when  you  configured  the  unit.  This  data  structure 
contains  all  the  information  lOX  needs  to  exercise  the  specified  unit. 
You  select  units  for  exercising  with  the  FILESll,  SELECT,  and  VERIFY 
commands.  These  commands  require  device  and  unit  specifications 
within  their  command  lines. 


4.5.1   The  FILESll  Command 

The  FILESll  command  selects  a  disk  unit  with  a  mounted  Files-11  volume 
for  an  I/O  exercise.  Exercising  with  FILESll  does  not  affect  the 
contents  of  the  disk  being  tested. 


4.5.2  The  SELECT  Command 

The  SELECT  command  selects  a  unit  with  an  NFS  volume  for  an  I/O 
exercise.  Exercising  with  SELECT  destroys  the  contents  of  the  volume 
being  exercised. 


4.5.3  The  VERIFY  Command 

The  VERIFY  command  selects  a  disk  unit  with  a  mounted  NFS  volume  for 
an  I/O  exercise.  VERIFY  does  not  write  on  the  volume  being  exercised. 
Exercising  with  VERIFY  does  not  affect  the  contents  of  the  volume 
being  exercised  because  VERIFY  only  reads  from  the  volume. 
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4.6   EXERCISE  PARAMETERS 

You  set  parameters  that  determine  how  lOX  exercises  units.  These 
exercise  parameters  determine  aspects  of  testing  such  as  how  long  an 
exercise  is  to  run,  how  many  records  are  tested  on  magnetic  tapes, 
what  range  of  blocks  are  tested  on  disks,  and  whether  output  is 
directed  to  your  terminal  or  to  a  log  file.  There  are  two  kinds  of 
exercise  parameters:   general  and  device  dependent. 


4.6.1  General  Exercise  Parameters 

The  following  commands  set  general  exercise  parameters   and   therefore 
affect  all  lOX  testing: 

CONFIGURE 

CONTROL_C 

LOGFILE 

PATTERN 

REPORTERRORS 

RUNTIME 

SUMMARYTIME 


4.6.2   Device-Dependent  Exercise  Parameters 

You  use  the  commands  listed  in  this  section  to  set  default  parameters 
for  the  units  that  you  select  for  exercising.  You  can  include  these 
commands  within  the  FILESll,  SELECT,  and  VERIFY  command  lines  to 
override  the  default  parameter  for  the  specified  unit. 


4.6.2.1  Parameter  Commands  for  Files-ll  Disks  with  FILESll  -  The 
following  commands  affect  the  exercising  of  disks  that  you  select  with 
the  FILESll  command: 

COMPAREDATA 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

TEMPORARYFILE 

You  can  use  these  commands  to  set  the  default  parameters  before  you 
use  the  FILESll  command  to  select  a  unit.  You  can  also  use  these 
commands  within  the  FILESll  command  line  to  override  the  default 
parameters  for  the  unit  being  selected. 


4.6.2.2  Parameter  Commands  for  NFS  Volumes  with  SELECT  -  The 
following  commands  affect  the  exercising  of  NFS  volumes  that  you 
select  with  the  SELECT  command: 

BADBLOCKS  RANDOM 

BUFFERSIZE  RANGE 

COMPAREDATA  RECORDS 

DENSITY  RETRIES 

ERRORLIMIT  VOLUMECHECK 

INTERLEAVE  WRITECHECK 
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You  us«  thes*  cotiufiands  with  the  SELECT  command  to  set  default 
parameters  for  exercising  a  unit  with  an  NFS  volume.  You  can  use  all 
but  BADBLOCKS  within  the  SELECT  command  line  to  override  the  current 
default  settings  for  the  device  being  selected. 


Table  4-2  shows  the 
devices. 


parameters   for   exercising  different   types  of 


Table  4-2 
Parameter  Commands  by  Device  Type  for  SELECT 


Magnetic 

NFS  Disks 

Cassettes 

DECtapes 

Tapes 

BADBLOCKS 1 

BUFFERSIZE 

COMPAREDATA 

BUFFERSIZE 

BUFFERSIZE 

COMPAREDATA 

ERRORLIMIT 

ERRORLIMIT 

COMPAREDATA 

ERRORLIMIT 

DENSITY 

ERRORLIMIT 

RECORDS 

RECORDS 

INTERLEAVE 

RETRIES 

RANDOM 

RANGE 

RETRIES 

VOLUMECHECK 

WRITECHECK 

1.  Cannot  be  used  within  SELECT  command  lini 


4.6.2.3  Paraaeter   CoMsands   for   NFS  Voluaes  with  VBRIPT  -  The 

following  commands  affect  the  exercising  of  NFS  disks  that  you  select 
with  the  VERIFY  command: 


BADBLOCKS 

BUFFERSIZE 

ERRORLIMIT  ,  ' 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

You  use  these  commands  with  the  VERIFY  command  to  set  default 
parameters  for  testing  a  unit  with  an  NFS  disk.  You  can  use  all  but 
BADBLOCKS  within  the  VERIFY  command  line. 


4.7   SETTING  PARAMETERS  FOR  EZBRCISIHG  PILE8-I1  VOLOHES 

This  section  shows  you  how  to  use  lOX   to  exercise  an  RL02  with   a 
Files-ll  structure.   Example  4-1  uses  the  following  lOX  commands: 

PARAMETBRLIST 

Displays  current  default  parameters,  lOX  buffer  space  statistics, 
and  device-dependent  parameters  for  devices  you  have  selected  for 
testing. 
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RUNTIME 


S«ts  the  length  of  time   (in  minutes)   that   lOX  exercises   the 
unlt(s)  you  have  selected  for  testing. 


PILESll 


Selects  a  disk  with  a  mounted  Files-11  volume  for  an  I/O  exercise 
that  preserves  the  contents  and  structure  oc   the  disk. 


TEMPORARY"" '.E 


Sets  the  size  of  the  temporary  file  that   lOX   uses   for   testing 
Files-11  disks  with  the  PILESll  command. 


START 


Starts  exercising  units  that  you  have  selected  for  testing. 


Example  4-1   Exercising  an  RL02  with  the  FILESll  Command 


>ALL  DLO: 

>MOU  DLO:  LOUIE 

>IOX 

IOX>PARAMETERLIST 
BUFFERSIZE"  1024. 
ERRORLIMIT-  10. 
INTERLEAVE-  4. 
PATTERN-  0. 
RECORDS-  1024. 
RUNTIME-  5. 
SUMMARYTIMS-  1. 
TBMPORARYFIL?.-  500. 


I 


COMPAREDATA-  YES   "^ 
CONTROL_C-  YES 
LOGFILE-  HO 
RANDOM-  YES 
REPORTERRORS-  YES 
RETRIES-  YES 
VOLUMECHECK-  YES 
WAIT-  YES 
WRITECHECK-  NO 


o 


Buffer  space  usage-  3290. : 1924. : 1924. :!. 


IOX>RUNTIME  3 

I0X>FILES11  DLO;  TEMP-800 

IOX>PARAMETER 


I 


Device  Mode  Buffers ize  Filesize/Records/Range  Parameters 


DLO: 


Fll 


512. 


800. 


<D 


COM  RET  RAN  ERR 


-10.  J 


BUFFERSIZE-  1024. 
ERRORLIMIT-  10. 
INTERLEAVE-  4. 
PATTERN-  0. 
RECORDS-  1024. 
RUNTIME-  3. 
SUMMARYTIME-  1. 
TEMPORARYFILE-500. 


COMPAREDATA-  YES 
CONTROL_C-  YES 
LOGFILE-  NO 
RANDOM-  YES 
REPORTERRORS-  YES 
RETRIES-  YES 
VOLUMECHECK-  YES 
WAIT-  YES 
WRITECHECK-  NO 


Buffer  space  usage-  3290. : 1308. : 1308. :  1. 
IOX>START  ^ 
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Th«  coanand  a*qu«nc«  in  Cxaapl*  4-1  docs  th«  following: 

%      Allocates  drive  DLO:. 

%      Mounts  tha  disk  with  label  "LOUIE"  in  DLOt. 

0  Invokes  an  installed  version  of  lOX  with  default  task  naae, 
...lOX. 

%     Displays  the  initial  default  paraaeters  with  PARAMETERLIST. 

^   Chanties  the  default  RUNTIME  to  three  Minutes. 

^  Selects  DLO:  for  F'ilLESll  testing  with  a  teaporary  file  slse 
of  800  blocks. 

Note  the  difference  between  the  defaults  displayed  by  the 
PARAMETERLIST  coamand  before  and  after  you  changed  RUNTIME  and  sleeted 
DLO:. 

%      Only  the  RUNTIME  default  has  changed. 

%      The  default  for  TEMPORARYPILE  has  not  changed. 

0  After  you  selected  DLO:  for  testing,  PARAMETERLIST  contains 
an  extra  line  at  the  beginning  that  displays  all 
device-dependent  paraaeters  for  the  selected  device.  Each 
selected  device  has  its  own  display  line.  There  are  five 
fields  of  paraaeters. 

%  Field  four  shows  that  the  teaporary  file  size  used  for 
PILESll  testing  for  DLO:  is  800.  blocks  instead  of  the 
500. -block  initial  default.  During  PILESll  testing,  this 
field  refers  only  to  teaporary  file  size. 

0  The  START  coaaand  begins  PILESll  testing  on  DLO:  for  a 
RUNTIME  of  three  ainutes  and  uses  a  teaporary  file  size  of 
800.   blocks. 


4.8   SBTTIMG  PARAMETERS  POR  EXERCISING  NFS  VOLUMES 

This  section  shows  exaaples  for  the  coaaand  sequences  that  test  a 
magnetic  tape  with  SELECT  and  an  NPS  disk  with  VERIFY.  Both  exaaples 
are  explained  in  detail. 


4.8.1   Exercising  a  Magnetic  Tape  with  the  SELECT  Coaaand 

The  coamand  sequence  in  Exaaple  4-2  tests  a  aagnetic  tape  by  using  a 
buffer  of  8K  bytes,  which  contains  the  data  pattern  052^52,  to 
transfer  data. 

Exaaple  4-2  illustrates  the  following  coaaands: 

PARAff-TERLIST 

Displays  current  default  parameters,  lOX  buffer  space  statistics, 
and  device-dependent  paraaeters  for  devices  you  have  selected  for 
testing. 
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PATTERN 

Sets  the  pattern  that  TOY   writes  and  roads  during  an  exercise. 

bufffr:^ize 

Sets  the  amojnt  of  data  that  lOX  transfers  for  every  read  or 
write  request  when  testing  NFS  disks,  magnetic  tapes,  and 
cassettes. 

DENSITY 

Sets  the  density  and  characteristic  word  of  the  specified 
magnetic  tape  or  displays  the  current  density  and  characteristic 
word  for  the  specified  magnetic  tape  Ui  't. 


SELECT 


Selects  a  unit  with  a  mounted   NFS   scratch   volume   for   an   I/O 
exercise  that  destroys  the  contents  of  the  volume 


RETRIES 


Determines  (for  magnetic  tapes  and  NFS  dijks)  whether  an  I/O 
driver  repeats  an  I/O  operation  after  the  driver  receives  errors 
during  the  ulceration. 


ERRORLIMIT 


Sets  the  maximum  nut>ber  of   errors   that   lOX   tolerates   between 
interval  reports  before  terminating  testing  on  «■  device. 


RECORDS 


Specifies  the  number  of  records  to  be  exercised  on  magnetic  tapes 
and  cassettes. 


START 


Starts  exercising  units  that  you  have  selected  for  testing. 


EXIT 


Terminates  lOX  processing  and  exits  from  lOX. 


Example  4-2   Exercising  a  Magnetic  Tape  with  the  SELECT  Command 


>ALL  HMO: 

^ 

>MOU  HMO: 

o 

>IOX 

; 

IOX>PARAHETERLIST 

BUFFERSIZE*  1024. 

o 

ERRORLIHIT-  10. 

INTERLEAVE-  4. 

PATTERNi=  0. 

o 

RECORDS-  1024. 

RUNTIHE-  S. 

SUHHARYTIHE-  1. 

TEHPORARYFILE-  500. 

COHPAREDATA=  YFS 
CONTROL_C=  YES 
L06FILE=  NO 
RANDOM'^  YES 
REPORTERRORS=  YES 
RETRIES-  YES 
VOLUHECHECK=  YES 
WAIT-  YES 
WRITECHECK=  NO 


Buffer  space  •jS4Se'=  3290.  :  1924.  :  1924  .:  1  . 


(continued  on  next  page) 
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Example  4-2   (Cont.)  Exercising  a  Magnetic  Tape  with  the  SELECT  Command 


IOX>PATTEKN  12  • 

IOX>EiUFFEf<  8192  0 

iox>[iENs  mho: 

Dentitw-  lAOO  BPI     Character ittic  Uord-  00400^ 

IOX>SELECT  mho:  RETRIES-MO  DENSITY-BOO  ERROF(  =  100  F(EC  =  20000 
IOX>FARAH 


)4  (octal)V' 


Device   Hode   Buffertize   Fi le«ize/Recordft/Ran«e   Fsraeeters 


NHOt 


NFS 


8192. 


BUFFERSIZE-  8192. 
ERRORLINIT-  10. 
INTERLEAVE-  4. 
PATTERN-  12. 
RECORDS-  1024. 
RUNTIME-  5. 
SUMMARYTIHE-  1. 
TEMPORARYFILE"  500, 


20000.      9 

COMPAREDATA-  YES 
CONTROL-C''  YES 
LOOFILE-  NO 
RANDOM-  YES 
REPORTERRORS-  YES 
RETRIES-  YES 
VOLUMECHECK*  YEP 
WAIT-  YES 
WRITECHECKa  NO 


Buffer  «pace  utade-  36058. :8188. : 18292. : 3. 


IOX>DENSITY  hMO: 

Densitw-  800  BPI 
IOX>SrART         0 
lOX  --  mho:  bad  blockf  112  (decmal)  160  (octal) 


Character iktic  Uord-  000000  (octal) 


> 


COM  ERR-10.  <B^ 


lOX  --  Suaearw  of  exerciser  activity  at  20-JUL-81  16:50:40 
TINE  --  Run.  1  »in.    Elapsed:  1  «in.    Reeairunfl:  4  *iri. 
mho:  --  230.  R/U  reauests  totaling  ?30.  record<i  with  1  errors 
AST't  executed:  346. 
Idle-loop  iterations:  344. 


lOX  --  MMO:  bad  block.  486  (decieal)  746  (octal) 
lOX  --  MMO:  bad  block.  551  <deci»al)  1047  (octal) 

lOX  --  SuMnarv  of  exerciser  activity  at  20-JUL-81  16:5«:50 
TIME  --  Run:  1  Kin.    Elapsed:  5  ein.    Renainins:  0  min. 
MMO:  --  217.  R/U  reouests  totaling  217.  records  with  7  errors 
AST's  executed:  325. 
Idle-looF  iterations:  321. 
ACCUMULATED    TOTALS: 


TIME  --  Run:  5  ein.    Elapsed:  5  ein.    Remairurid :  0  Hiin. 

MMO:  --  lfl2l.  R/U  reauests  totaling  lfl21.  retoids  with  3  errors 

AST's  executed:  lt686. 

Idle-loop  iterations:  1>670. 

IOX>EXIT 
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Th«  command  sequence  in  Example  4-2  does  the  following: 

^  Allocates  drive  MMO:,  mounts  the  magnetic  tape,  and  invokes 
an  installed  version  of  lOX. 

On  RSXllM-PLUS  systems,  you  mount  the  tape  wiht  the  /FOREIGN 
switch. 

^   Displays  the  initial  defaults. 

%      Selects  pattern  number  12  to  be  written  to  the  tape. 

O   Changes  the  default  BUFFERSIZE  from  1024.   to  8192.   (8K). 

0  Displays  the  default  density  and  characteristic  word  on  the 
magnetic  tape  mounted  in  drive  MMO:. 

9  Selects  MMO:  for  NFS  testing  with  SELECT,  overriding  the 
defaults  for  RETRIES,  ERRORLIMIT  and  RECORDS,  and  sets  the 
tape  density  at  800. 

9  Checks  the  parameters  with  PARAMETERLIST  and  DENSITY. 

O  Changes  the  BUFFERSIZE  default. 

9  Changes  the  PATTERN  default. 

^  Displays  the  device  display  line  for  MMO:. 

0  Shows  the  current  BUFFERSIZE  of  MMO:. 

^  Shows  that  the  number  or  records  to  be  tested  is  20000. 

d)  Starts  NFS  testing  with  SELECT  on  MMO:. 

The  remainder  of  Example  4-2  shows  interval  reports,  error  reports, 
and  an  accumulated  totals  generated  at  your  terminal  during  this 
exercise.  These  reports  are  discussed  fully  in  Section  4.10.  When 
the  exercise  has  finished,  you  exit  to  the  operating  system  monitor 
unless  you  want  to  do  more  testing. 


4.8.2   Exercising  with  the  VERIFY  Comnand 

The  command  sequence  in  Example  4-3  performs  oscillating  seeks  between 
blocks  1  and  1000  to  align  disk  heads.  It  reads  only  four  bytes  per 
data  transfer,  which  is  the  minimum.  No  error  or  summary  reporting  is 
required.   The  exercise  runs  i  itil  you  abort  It. 

Example  4-3  illustrates  the  following  commands: 

PARAMETERLIST 

Displays  current  default  parameters,  TOX  buffer  space  statistics, 
and  device-dependent  parameters  for  devices  you  have  selected  for 
testing. 

VERIFY 

Selects  a  mounted  disk  for  an  NFS  exercise  that  reads  buffers  of 
data  without  writing  on  the  disk,  performing  data  comparisons,  or 
destroying  the  contents  of  the  disk. 
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RANGE 

Sets  the  minimum  and  maximum  block  numbers  for  NFS  testing  on  the 
specified  disk. 

3UFFERSIZE 

Sets  the  amount  of  data  that  lOX  transfers  for  every  read  or 
write  request  when  testing  NFS  disks,  magnetic  tapes,  and 
cassettes. 


RANDOM 


Directs  lOX  to  select  either  random  or  sequential  blocks  for  disk 
testing. 


INTERLEAVE 


Sets  the  number  of  blocks  to  be  skipped  before  lOX  writes  the 
next  buffer  of  data  for  disk  testing  (applies  only  to  sequential 
testing  which  you  determine  with  the  RANDOM  command) . 

ERRORLIMIT 

Sets  the  maximum  number  of  errors  that  lOX  tolerates  between 
interval  reports  before  terminating  testing  on  a  device. 

REPORTERRORS 

Enables  or  disables  error  reports. 

SUMMARYTIME 

Determines  how  often  (In  minutes)  lOX  will  output  interval 
reports. 

RUNTIME 

Sets  the  length  of  time  (In  minutes)  that  lOX  exercises  the 
unit(s)  you  have  selected  for  testing, 

LOGFILE 

Determines  whether  lOX  directs  activity  and  error  reports  to  your 
terminal  or  to  a  log  file. 

START 

Starts  exercising  units  that  you  have  selected  for  testing. 

CTRL/C 

With  CONTROL_C  enabled,  allows  you  to  enter  lOX  commands  while  an 
exercise  Is  in  progress. 

ABORT 

Terminates  execution  of  an  I/O  exercise. 
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Example  4-3   Exercising  an  NFS  RK07  with  tha  VERIFY  Command 


>ALL  OHOt 
>HOU  DHO: 
>IOX 
IOX>PAR 

BUFFERSIZE-  1024. 
ERRORLIHIT-  10. 
INTERLEAVE-  4. 
PATTERN-  0. 
RECORDS-  1024. 
RUNTIME-  5. 
8UNNARYTIME-  1. 
TEHPORARYFILE-  500. 


} 


COHPAREDATA-  YES 
CONTROL.C-  YES 
LOOFILE^'  NO 
RANDOH-  YES 
REP0RTERR0R8"  YES 
RETRIES-  YES 
yOLUHECHECK-  YEK 
WAIT-  YES 
WRITECHECK-  NO 


Buffar  tpaca  utaae-  3290. : 1924 .: 1924.  :  1 . 

IOX>WERIFY  DHO:  RANGE'^IJIOOO  BUF-4  RAND=N  1NTER«999  ERR-50000 

IOX>REFORTERRORS  NO 

IOX>SUHHARY  0 

IOX>RUNTIME  0 

I0X>L06  Y 

I0X>PAR 


•\ 


Davica 
OMO: 


Hoda 
VFY 


Buf f artiza 
4. 


BUFFERSIZE-  1024. 
ERRORLINIT-  10. 
INTERLEAVE-  4. 
PATTERN-  0. 
RECORDS-  1024. 
RUNTIME-  0. 
SUHMARYTIME-  0. 
TEMPORARYFILE-  500. 


Filaftiza/Racords/Rande   Paramatar* 

1.  ->  liOOO.  RET  INT-999. ERR-50000. 

COMPAREDATA-  YES 
CONTROL_C=  YES 
LOGFILE-  YES 
RANDOM-  YES 
REPORTERRORS-  NO 
RETRIES-  YES 
V0LUMECHECK=  YES 
WAIT-  YES 
WRITECHECK-  NO 


Buffar  spaca  uaaaa-  3290. : 1912. : 1912. : 1 . 


I0X>ST 
I0X>'-C 
I0X>AB0RT 


} 


The  command  sequence  in  Example  4-3  does  the  following: 

O   Allocates  drive  DM0:,  mounts  the  RK07  for  NFS   testing, 
invokes  lOX. 


and 


On  RSXllM-PLUS  systems,   mount  disks  with   the  /FOREIGN 
■witch. 

Displays  the  initial  default  par^n->.er. 

Selects   DM0:    for   read-only   MS   testing   with    VERIFY, 
overriding  the  following  defi-ultaz 

a.  RANGE  —  blocks  1  through  1000 

b.  BUFFERSIZE  —  minimum,  four  bytes 

c.  RANDOM  block  testing  turned  off  and   INTr.RLEAVE   set   at 
999  so  that  lOX  tests  only  blocks  1  and  1000 
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d.  ERRORLIMIT  set  Impossibly  high  (50000.)  so  that  lOX  will 
not  deselect  DM0:  no  matter  how  many  errors  are 
encountered  during  the  exercise 

0  Turrs  off  REPORTERRORS  so  that  no  error  reports  are 
generated.  Turns  SUMMARjfTIME  off  so  that  no  Interval 
reports  will  be  generated.  Sets  RUNTIMZ  to  zero  so  that  lOX 
runs  tiie  exercise  until  you  abort  it.  Sets  LOGFILE  YES  to 
direct  all  output  to  the  log  file,  lOX.LOG,  instead  of  to 
the  terminal. 

0  Shows  that  the  RUNTIME,  SUMMARYTIME,  and  LOGFILE  defaults 
have  been  reset  and  that  DM0:  is  being  tested  with  VERIFY, 
using  a  bufferslze  of  4.,  over  a  rrnge  of  1000.  blocks, 
with  RETPIES  enabled,  INTERLEAVE  set  at  999,  and  ERRORLIMIT 
set  at  50000. 

0  Shows  how  to  start  the  exercise  using  the  START  command  and 
entor  Interactive  Mode  with  CTRL/C  so  you  can  enter  the 
ABORT  command  to  abort  the  exercise. 

Example  4-4  shows  the  contents  of  the  log  file  for  Example  4-3. 

Example  4-4   Log  File  Output  for  Example  4-3 

lOX  --  20-JUL-81  18:24tl2  ««»««««*  EXERCISER  STARTED  »«««««»» 
Device   Hode   Bufferslze   Fi  lesize/Recorde/Rsrisle   Psnuketers 


DHOS 


VFY 


4. 


1.  ->  1.000. 


RET  INT-999.  ERR=50000. 


BUFFERSIZE>  1024. 
ERRORLIMIT-  10. 
INTERLEAVE-  4. 
PATTERN^  0. 
RECORDS-  1024. 
RUNTIHE-  0. 
SUMMARYTIME-  0. 
TEMPORARYFILE-  500. 


COMPi^REDATA-  YES 
CQNTrcOL-C-  YES 
LOGFILE*  YES 
RANDOM-  YES 
REP0RTERRORS=  NO 
RETRIES=  YES 
VOLUMECHECK-  YES 
WAIT-  YES 

writechlCk-  no 


Buffer  ^pace  usade-  3290. S 1812 .: 1812.  !  1  . 


lOX  —  Suanaru  of  i?xerciser  activit-J  at  20-JUL-81  1B;27{28 

TIME  --  Run'  3  min.    Elapsed:  3  nin.    Reni<i.nlnd:  6SS33  nin. 
DMOJ  --  3»075.  R/W  reouestt  totaling  3»075.  blocks  .lith  no  errors 
AST's  executed:  3>081 . 
Idle-loop  iterations!  2f982. 


ACCUMULATED 


TOTALS 


TIME  --  Run:  0  nin.    Elapsed:  3  nin.    Renainins:  ASS33  nun. 
DM0:A  --  3f076.  R/W  reauests  ♦otalina  3»076.  blocks  with  no  errors 
AST's  executed:  3f082. 
Idle-loop  iterations:  2»982. 

lOX  --  20-JUL-81  18:27:31  »«*♦»*««  EXERCISER  ABORTED  *«**««*♦ 

The  log  file  output  terminates  when  you  abort  the  Exerciser.  The  log 
file  begins  with  t'.ie  time  and  date  tha*:  the  exercise  began  and  the 
current  default  parameters  as  displayed  by  the  PARAMETERLIST  command. 
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4.9   lOX  OPERATING  MODES 

lOX  oDcratcii  in  thrco  modes:  Comnand,  ExecuCion,  and  Interactive. 
This  section  discusses  the  functions  of  these  modes,  how  you  enter  and 
exit  each  mode,  and  what  lOX  commands  are  valid  in  each  mode. 


4.9.1   Cowsand  Mod* 

lOX  is  in  Command  Mode  after  you  have  invoked  it  and  have  received  the 
first  lOX  prompt.  (Section  4.2  discusses  lOX  prompts.)  In  Command 
Mode,  no  devices  are  being  exercised,  and  tasks  initiated  by  the 
EXECUTE  command  are  queued  but  not  active  (see  Section  4.12  for  a 
complete  description  of  the  EXECUTE  command.)  You  usually  set 
parameters,  select  devices  for  testing,  and  initiate  tasks  to  be 
executed  in  Command  Mode. 

When  you  press  the  RETURN  key,  you  receive  an  lOX  prompt.  When  you 
press  CTRL/C,  you  exit  to  MCR  for  one  command  line. 


4.9.2   Execution  Mode 

When  you  begin  an  I/O  exercise  by  entering  the  START  command,  lOX 
exits  romm^nd  Mode  and  enters  Execution  Mode.  Exercises  begin  on 
selected  devices,  tasks  initiated  with  the  EXECUTE  command  begin 
executing,  the  lOX  clock  is  turned  on,  and  activity  and  error 
reporting  begin. 

You  set  the  CONTROL_C  parameter  in  Command  Mode  to  allow  or  disallow 
you  to  enter  lOX  commands  while  an  exercise  is  in  progress.  CONTROL_C 
YES  is  the  initial  default  setting. 

Tf  you  have  set  C0NTROL_C  NO,  then  CTRL/C  in  Execution  Mode  gives 
control  to  MCR  and  you  receive  the  MCR  prompt  ">"  every  time  you  press 
the  RETURN  key  and  "MCR>"  every  time  you  press  CTRL/C  until  the 
exercise  has  terminated.  With  CTRL/C  disabled,  you  cannot  i- terrupt 
the  exercise.  However,  you  can  terminate  it  with  the  MCR  ABORT 
command. 

If  you  have  set  CONTROL_C  YES,  lOX  does  not  accept  any  input  from  your 
terminal  except  CTRL/C.  If  you  try  to  enter  anything  but  CTRL/C,  you 
receive  an  error  message  for  each  key  you  press: 

lOX  --  Only  *C  Allowed 

When  you  press  CTRL/C,  you  receive  the  lOX  prompt  instead  of  the  MCR 
prompt  and  lOX  exits  Execution  Mode  and  enters  Interactive  Mode. 


4.9.')   Interactive  Mode 

You  have  access  to  Interactive  Mode  only  if  CONTROL_C  is  enabled. 
When  you  press  CTRL/C  in  Execution  Mode,  lOX  exits  Execution  Mode  and 
enters  Interactive  Mode.  In  Interactive  Mode,  the  RETURN  key  and 
CTRL/C  have  the  same  functions  that  they  have  in  Command  Mode. 

In  Interactive  Mode,  the  exercise  and  tasks  initiated  by  the  EXECUTE 
command  are  running.  '.ctivity  reports  and  error  reports  directed  to 
yoi'.'  terminal  are  suopendei  if  you  'nave  set  LOGFILE»NO.  If  you  have 
set  LOGFILE-YES,  /<ct  vity  anr<  error  reports  continue  as  in  Exec:ition 
Mode, 
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All  lOX  commands  sxcapt  the  followinq  ar*  valid  in  Int*ractiv«  Mod*: 

BUFFKRSIZE 

PATTERN 

RUNTIME 

START 

RESTART 

If  you  enter  these  commands,  lOX  prints  the  error  message: 

lOX  --  Command  valU  only  In  command  mode 

You  can  use  the  BUFFERSIZF:  command  within  the  SELECT  and  VERIFY 
command  lines  to  override  the  current  defaults  for  the  device  being 
selected,  but  the  BUFFERSIZE  command  cannot  be  used  by  itself  to  reset 
the  default. 

Although  you  cannot  use  the  PATTERN  command  to  choose  a  different 
pattern  to  be  written  to  the  volumes  being  tested,  you  can  use  PATTERN 
with  no  argument  to  display  all  the  patterns. 

The  following  commands  are  valid  only  in  Interactive  Mode: 

ABORT 

PRINTS'JMMARY 
PROCEKU 
SPY 

Although  you  can  issue  PRINTSUM»1ARY  and  SPY  in  Command  Mode  without 
generating  an  error  message,  these  commands  display  meaningful 
Information  only  when  you  issue  them  In  Interactive  Mode. 

When  you  issue  the  ABORT  command,  lOX  exits  Interactive  Mode  and 
enters  Command  Mode.  The  ABORT  command  with  no  qualifiers  terminates 
all  exercising  and  all  tasks  Initiated  by  the  EXECUTE  command.  This 
form  of  ABORT  is  valid  only  in  Interactive  Mode  because  in  Command 
Mode  there  can  be  no  exercise  or  active  tasks  to  abort. 

The  PROCEED  command  exits  Interactive  Mode  and  enters  Execution  Mode 
unless  no  activity  remains  when  you  issue  PROCEED,  in  which  case  lOX 
aborts  the  exercise. 


4.10   I OX  OUTPUT 

lOX  generates  two  types  of  output:  activity  reports  and  error 
reports.  Activity  reports  summarize  lOX  processing  information,  such 
as  how  long  an  exercise  will  run  and  how  many  ASTs  have  been  executed. 
There  are  two  kinds  of  error  reports:  data  compare  error  reports, 
that  show  where  lOX  finds  errors  on  the  volume  being  tested,  and  I/O 
error  reports,  that  indicate  failed  QIOs  from  a  dnver.  You  use  the 
LOGFILE  command  (see  detail  in  Section  4.12)  to  direct  activity  and 
error  reports  to  your  terminal  or  to  a  log  file. 


4.10.1   Activity  Reports 

There  are  three  types  of  activity  reports: 

Accumulated  Totals 

An  activity  report  at  the  end  of  an  lOX  exercise  that  reports  the 
activity  for  the  entire  exercise 
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Interval  Reports 


An  activity  rep>ort  that  summarizes  lOX  activity  in  the  time 
intervals  set  by  the  SUMMARYTIME  command 

Summary  Reports 

A  report  of  activity  between  the  last  Interval  Report  and  the 
time  you  enter  the  PRINTSUMMARY  command  to  request  a  summary 
report. 

Section  4.12  discusses  the  SUMMARYTIME  and   PRINTSUMMARY  commands   In 
detail. 


4.10.1.1   The  Pornat  of  Activity  Reports  -  The   formats  of    activity 

reports   are   indentical   except   for   the   first   line.  Interval  and 

summary  reports  begin  with  the  time   and   date   of   the  report.    For 
example: 

lOX  —  Summary  of  exerciser  activity  at  20-JUL-81  11:16:2*5 

The  accumulated  totals  report  does  not  give  the  time  or   date   of   the 
report  and  begins: 

ACCUMULATED    TOTALS: 


4.10.1.2  The  Content  of  Activity  Reports  -  The  content  of  all 
activity  reports  is  identical.  The  following  is  an  interval  report  of 
an  exercise  that  tests  SYO:. 

lOX  —  Summary  of  exerciser  activity  at  31-DEC-80  11:18:29 

TIME  —  Run:  1  min.     Elapsed:  2  min.    Remaining:  3  min. 

SYO:  —  1,874.  R/W  requests  totaling  1,874.  blocks  with  no  errors 

ASTs  executed:  1,875. 

Idle-loop  iterations:  1,803. 

The  activity  report  contains  the  following  information: 

•  Timing  information 

-  Time  between  reports  as  set  in  the  SUMMARYTIME  command 

-  Time  that  the  exercise  has  been  in  progress  to  the  nearest 
minute 

-  Time  remaining  to  the  nearest  minute   before  the  exercise 
will  finish 

•  Unit  information  for  each  unit  being  tested 

-  Number  of  I/O  requests  to  the  unit 

-  Number  of  block  exercises  on  the  unit 

-  Number  of  error  encounters  on  the  unit 
e   Number  of  ASTs  executed 

e   Number  of  iterations  through  the  idle  loop 
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You  use  the  following  commands  to  control  the  output  of  activity 
reports: 

LOGFILE 
PRINTSUM»1ARY 
SPY 
SUMMARYTIME 

Section  4.12  discusses  each  of  these  commands  in  detail. 


4.in.2   Error  Reports 

You  use  the  REPOHTERRORS  command  to  enable  or  disable  error  reports. 
Section  4.12  discusses  the  REPORTERRORS  command  in  detail.  There  are 
two  kinds  of  error  reports;   data  compare  error  reports  and  I/O  error. 


4.10.2.1  Data  Compare  Error  .'Reports  -  A  data  compare  error  means  that 
the  driver  returned  a  success  I/O  code  to  lOX  but  that  the  data 
written  to  the  volume  and  the  tiata  read  from  the  volume  did  not  match. 
The  following  is  an  error  report  generated  by  a  data  compare  error: 

lOX  —  DRl:  data  compare  error  at  block  33,937  (decimal)  102221  (octal) 
Good  Data:  0057*;7    Bad  D.ita:  155555  O  A 

Word  Position:  0  (decimal)  0  (octal)  ^ 
Buffer  contained  255.  additional  errors  0 

0  Identifies  the  device  on  which  lOX  encountered  an  error. 
It  reports  the  starting  block  (in  both  decimal  and  octal) 
in  which  the  error  was  found. 

0  Shows  the  "good  data"  that  lOX  wrote  to  the  volume  and  the 
"bad  data"  that  lOX  read  from  the  volume.  Only  the  first 
error  encountered  in  the  test  buffer  is  reported. 

0  Shows  the  position  of  the  first  word  in  the  test  buffer 
that  generated  a  mismatch  during  the  current  operation. 
Only  the  first  error  encountered  in  the  test  buffer  is 
reported . 

O   Shows  how  many  other  errors  were  found  in  the  test  buffer. 


4.10.2.2  I/O  Error  Reports  -  There  are  12  I/O  errors.  If  a  QIO 
fails,  the  driver  returns  an  I/O  failure  code  to  lOX.  lOX  generates  a 
specific  I/O  error  report  as  a  result  of  the  following  I/O  errors: 

I/O  Code  Description 

IE. ABO  Operation  aborted 

lE.BBE  Bad  block 

lE.DAO  Data  overrun 

lE.DNR  Device  not  ready 

IE. EOT  End-of-tape  detected 

lE.FHE  Fatal  hardware  error 

lE.OFL  Device  off-line 

lE.PRI  Privilege  violation 

lE.VER  Unrecoverable  error 

lE.WCK  Write  check  error 

lE.WLK  Write-lock  error 

N/A  Unexpected  error 
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These  error  codes  are  shown  In  the  RSXllM/M-PLUS  I/O  Drivers  Reference 
Manual .  Section  4.13  of  this  chapter  presents  the  format  and  content 
of  the  12  error  messages  that  TOX  generates  because  of  these  error 
codes. 


4.11   THE  TASK  BUILD  FILE 

You  can  change  the  initial  defaults  for  lOX  parameters  as  well  as 
other  defaults  of  the  lOX.TSK  by  editing  the  lOX  task-build  file, 
TOXBLD.BLD. 

.On  R8X-11M  systems,  this  file  *a  located  on  your  system  disk  in  uro 
[1,241  for  mapped  systems  and  [1,20]  for  unmapped  systems. 

On  RSX-llM-PLUS  systems,  this  file  is  located  on  your  syatem  disk  In 
UPD  [1,241. 


4.12   COMMAND  DESCRIPTIONS 

This  section  provides  complete  descriptions  of  the  commands  in  the  lOX 
Command  Language.   Each  command  description  includes: 

e  Kind  of  command  by  category:  Function,  Display,  Parameter, 
and  Control 

e   All  command  formats 

e   Qualifier  descriptions 

e  Operating  mode  restrictions  (where  no  mode  restrictions  are 
placed  on  a  commonc ,  it  is  valid  in  Command  Mode  and 
Interactive  Mode) 

e   Kinds  of  devices  and  testing  to  which  the  command  applies 

e   Initial  defaults  if  applicable 

The  commands  are  presented  alphabetically. 

Commands  may  be  issued  in  all  uppercase,  all  lowercase,  or  part  upper 
and  part  lowercase.  You  can  abbreviate  commands  using  any  combination 
of  characters  that  appear  unique  to  the  lOX  Command  Language. 

All  commands  are  represented  by  unabbreviated  uppercase  letters.  All 
lowercase  words  in  the  presentations  of  command  syntax  indicate  that 
you  substitute  alphanumeric  characters  for  the  word. 

All  numerical  qualifiers  are  decimal. 

Brackets  [  1  indicate  optional  elements  in  the  command  line. 
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ABORT 


A[B0RT1  [/ALL] 

( tasknamel 

The  ABORT  command  is  an  lOX  control  command.   You  cannot  use  the  ABORT 
command  to  abort  a  task  that  has  attached  your  terminal,  such  as  PIP. 

There  are  three  forms  of  ABORT; 


ABORT 


ABORT  /ALL 


Terminates  the  execution  of  an  I/O  exercise  and 
tasks  initiated  by  the  EXECUTE  command.  This  form 
of  ABORT  is  valid  only  in  Interactive  Mode 
(testing  in  progress)  because  in  Command  Mode  (no 
testing  in  progress)  there  can  be  no  running 
exercise  or  active  tasks  to  abort. 

In  Interactive  Mode  this  form  of  ABORT  terminates 
the  execution  of  all  tasks  initiated  by  the 
EXECUTE  command  and  removes  the  tasks  from  the 
list  of  tasks  to  be  executed.  In  Command  Mode, 
this  form  of  ABORT  removes  all  tasks  from  the  list 
of  tasks  to  be  executed. 


ABORT  taskname 


In  Interactive  Mode  this  form  of  ABORT  terminates 
the  execution  of  a  task  initiated  by  the  EXECUTE 
command  and  removes  the  task  from  the  list  of 
tasks  to  be  executed.  In  Command  Mode,  this  form 
of  ABORT  removes  the  task  from  the  list  of  tasks 
to  be  executed. 
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BADBLOCKS 

BAfDBLOCKS)  ddnn:   (blocknumbersl 

you  can  use  BADBLOCKS  as  a  device-dependent  parameter  command  or  a 
display  command.   BADBLOCKS  applies  only  to  NFS  disk  testing. 

BADBLOCKS  requires  a  device  specification  "ddua:".  To  use  the 
BADBLOCKS  command,  the  disk  that  you  specify  must  already  be  selected 
for  NFS  operations. 

BADBLOCKS  as  a  Parameter  Command 

With  the  BADBLOCKS  Parameter  Command,  you  can  omit  the  bad  blocks  on 
your  disk  from  lOX  testing.  BADBLOCKS  does  not  find  bud  blocks  on 
your  disk;  it  allows  you  to  enter  those  blocks  that  the  BAD  utility 
has  reported  to  be  bad  into  an  lOX  badblocks  list  for  the  disk.  When 
you  exercise  the  disk  with  SELECY  or  VERIFY,  the  blocks  that  you 
entered  in  the  list  will  not  be  exercised.  lOX  omits  only  those 
blocks  that  you  listed  as  blocknumbers  in  the  BADBLOCKS  command  line; 
blocks  marked  as  bad  by  the  BAD  utility  but  not  entered  into  the 
badblocks  list  with  tne  BADBLOCKS  command  are  treated  as  good  blocks 
by  lOX. 

Once  you  have  made  entries  in  the  badblocks  list  for  a  disk,  the  block 
numbers  that  you  entered  remain  on  the  list  until  you  deselect  the 
disk. 

There  are  two  formats  for  entering  bad  blocks  into  the  badblocks  list. 
One  format,  using  DM1:   as  an  example,  is: 

BADBLOCKS  DM1:  3 

This  command  line  enters  block  3  In  the  badblocKS  list  for  DM1:. 
Another  example: 

BADBLOCKS  DM1:   3,4,5,11,12,13,99,151 

This  command  line  enters  blocks  3,  4,  5,  11,  12,  13,  99,  and  151  into 
the  badblocks  list  for  DM1:. 

The  second  format  has  the  form: 

beg :num 
beg 

Beginning  block  number 
num 

Number  of  sequential  blocks 
For  example: 

BADBLOCKS  DM1:   3:3,10:4,100:50 

This  command  line  enters  blocks  3  through  5,  10  through  13,  and  100 
through  149  into  the  badblocks  list  for  DM1:.  You  can  use  this  format 
for  the  length  of  a  single  command  line. 
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BADBLOCKS  (Cont.) 


You  cnn  use  the  two  formats  together  on  the  same  command  line.  For 
example: 

BADBLOCKS  DM1:   3  J  3, lOi 4, 99, 100: 50, 151 

This  command  line  enters  blocks  ■<  through  5,  10  through  13,  99,  100 
through  149,  and  151  into  the  BAOBLOCK  list  fo.  DHl : . 

BADBLOCKS  as  a  Display  Coimand 

BADBLOCKS  with  no  blocknumber s  specified  is  a  Display  Command.  For 
example: 

BADBLOCKS  DM1 : 

This  command  line  displays  the  badblocks  list  for  DM1:.  If  you  had 
typed: 

BADBLOCKS  DM1:   1:5,10:4,99,100:50,151 

lOX  would  display: 

000003:005 
000010:004 
000099:051 
000151 :001 

lOX  displays  the  badblocks  list  using  a  variation  of  the  second 
format.  It  strings  consecutive  blocks  together  even  if  you  did  not 
enter  them  using  the  second  format.  For  example,  in  the  command  line 
you  entered: 

99,100:50 

However,  when  lOX  displays  the  badblocks  list,  it  doss  not  separate 
these  because  blocks  99  and  100  are  consecutive  blocks.  It  does  not 
display  two  lines:  one  for  block  99  and  one  for  blocks  100  through 
149.  Instead,  it  displays  (line  three)  the  badblocks  list  in  one  line 
as  if  you  had  entered  51  blocks  (99:51)  beginning  with  block  99  in  the 
badblocks  list. 
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BUFFERSIZE 

BUlFFERSI^E]  bufferslse 

BUFFERSIZE  Is  a  devlce-depenrtent  parameter  command.  You  use 
BUFFERSIZE  to  determine  the  amount  of  data  that  lOX  transfers  for 
every  read/write  request  whon  exercising  NFS  disks,  magnetic  tapes, 
and  cassettes.  TOX  stores  the  specified  size  in  bytes  and  rounds  this 
number  up  to  the  next  four-byte  boundary. 

Whan  you  use  the  random  data  pattern  (PATTERN  0) ,  BUFFERSIZE  should 
never  exceed  3400.  bytes  or  lOX  generates  unpredictable  data  compare 
errors. 

Although  read/write  buffers  are  used  for  FILESll  disk  testing  and  for 
NFS  testing  with  DECtapes,  the  buffersize  for  these  devices  is  fixed. 
A  512. -byte  buffer  is  used  for  all  FILESll  testing.  A  1024. -byte 
buffer  is  used  for  all  DECtape  testing. 

The  BUFFERSIZE  command  is  valid  only  in  Command  Mode  when  used  by 
itself.  In  addition,  it  is  valid  only  if  units  are  not  currently 
selected;  that  is,  you  must  set  your  default  buffersize  before  you 
select  any  units  for  testing.  However,  you  can  jse  the  buffersize 
command  in  the  SELECT  and  VERIFY  command  lines  to  override  the  default 
buffersize  for  the  selected  device  as  long  as  you  set  the  buffersize 
smaller  than  the  default. 

The  Initial  default  is  1024.   bytes. 
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COMPAREDATA 


COMfPAREDATA)  Y[ES1/N[0) 

COMPAREDATA  Is  a  device-dependent  parameter  command  for  PILBSH  and 
SELECT  that  applies  to  the  testing  of  devices. 

COMPAREDATA  enables  or  disables  the  checking  of  the  data  pattern. 
COMPAREDATA  YES  enables  data  pattern  checking;  COMPAREDATA  NO 
disables  data  pattern  checking.  When  you  direct  lOX  to  compare  data 
patterns,  it  compares  the  data  that  it  writes  to  the  unit  with  the 
data  it  reads  from  the  unit.  If  the  data  read  does  not  match  the  data 
written,  lOX  prints  a  data  compare  error  report.  Section  4.10.2.1 
discusses  data  compare  error  reports  in  detail. 

You  can  use  COMPAREDATA  within  the  command  lines  of  FILESll  and  SELECT 
to  override  the  current  COMPAREDATA  setting  for  the  device  beinq 
tested. 

The  Initial  default  is  COMPAREDATA  YES. 
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CONFIGURE 

CONF[IGURE]  [dduus [-type] 1  .... 

CONFIGURE  Is  a  general  parameter  command  and  a  display  command.  You 
use  CONFIGURR  as  a  parameter  command  to  add  devices  to  your  test 
configuration  and  as  a  display  command  to  display  the  current 
configuration. 

lOX  configures  by  default  one  of  each  supported  device  type  as  unit 
"0".  You  can  add  any  device  to  the  test  configuration  to  which  you 
can  assign  a  logical  device  name  by  using  the  MCR  ASN  command.  When 
you  configure  a  device,  lOX  adds  the  device  to  its  list  of  devices 
available  for  testing  and  creates  an  empty  data  structure  for  the 
device. 

If  a  device  Is  not  already  Included  In  the  test  configuration,  you 
must  configure  it  before  you  can  select  It  for  testing.  lOX  does  not 
unconflgure  devices  at  the  end  of  an  exercise.  Once  you  have  Included 
a  device  in  the  test  configuration,  only  RESTART  will  unconflgure  It. 

CONFIGURE  with  no  qualifiers  displays  the  current  test  configuration. 
To  find  out  if  a  device  is  already  configured,  type: 

IOX>CONFIGURE 

lOX  responds: 

Disks: 

DBO   DDO   DFO   DKO   DLO   DM0   DPO   DRO   DSO   DUO 

DXO   DYO   EMO   SYO 

Tapes : 

CTO   DTO   MFO   MMO   MSO   MTO 

To  add  devices  to  the  test  configuration,  type: 

IOX>CONFIGURE  DKl :   DBl:   0B2:   XX:   YY :   MM5:   MQ1:"TAPE 

This  command  line  configures  devices  DKl:,  DBl:,  DB2:,  XXO: ,  and  YYO: 
as  disk  units.   It  configures  devices  MM5:   and  MQl :   as  tape  units. 

Yov.   must  separate  unit  specifications  with  spaces  or  tabs. 

Use  the  display  form  of  CONFIGURE  to  check  that  these  devices  have 
been  added  to  your  configuration: 

IOX>CONF 

Disks : 

DBO   DBl   DB2   DDO   DFO   DKO   DKl   DLO   DM0   DPO 

DRO   OSO   DUO   DXO   DYO   EMO   SYO   XXO   YYO 

Tapes : 

CTO   DTO   MFO   MMO   MM5   MQl   MSO   MTO 
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CONFIGURE  (Cont.) 


The  device  type  defaults  are  as  follows  If  you  do  not  specify  a  device 
type  when  you  configure  a  device: 


lOX  maintains  consistency  in  configuring  device  units, 
Therefore,  you  cannot  configure  DKl:,  DBl:,  or  DB2:  as 
tapes.  The  same  holds  true  for  MM5:  —  you  cannot  configure 
it  as  a  disk.  In  both  cases,  lOX  generates  the  following 
error  message: 

lOX  —  dduu:   specified  device  type  Is  inconsistent 

2.  For  devices  with  mnemonics  that  have  not  been  previously 
configured,  the  default  Is  disk.  Hence,  in  the  following 
example,  lOX  configures  both  XX:  and  YY:  as  disks,  and  MQl: 
as  a  tape. 

IOX>CONF  DKl:   DBl:   DB2:   XX:   YY:   MM5:   MQ1:=TAPE 

lOX  responds  by  displaying  the  following  messages: 

lOX  —  XXO:   device  type  not  specified  -  defaulting  to  'DISK' 
lOX  —  YYO:   device  type  not  specified  -  defaulting  to  'DISK' 
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CTRL/C 


CTRL/C  is  a  control  command.  In  Command  Mode  and  Interactive  Mode, 
CTRL/C  generates  an  MCR  prompt  "MCR>"  allowing  you  to  enter  one  MCR 
command  line.  The  function  of  CTRL/C  in  Execution  Mode  depends  on 
whether  CONTROL_C  has  been  set  YES  or  NO.  If  you  have  set  CONTROL_C 
NO,  then  CTRL/C  generates  the  MCR  prompt  "MCR>"  as  it  does  in  Command 
and  Interactive  Modes.  If  you  have  set  CONTROL_C  YES,  then  CTRL/C 
exits  lOX  from  Execution  Mode  and  enters  Interactive  Mode. 

Section  4.9  describes  the  three  lOX  operation  modes  in  detail. 

CTRL/C  exits  to  MCR  by  default  in  Command  and  Interactive  Modes.  In 
Execution  Mode,  CTRL/C  exits  Execution  Mode  and  enters  Interactive 
Mode  by  default. 
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CONTROL_C 


C0NT(R0L_C1  Y(ES1/Nr01 

CONTROL  C  is  a  general  parameter  command.   You  use  CONTROL_C  to  enable 
or  disaBle  the  use  of  CTRL/C  to  interrupt  an  I/O  exercise. 

Command  Mode 

CTRL/C  r)ives  control  to  MCR  for  one  command  line.  The  CONTROL_C 
parameter  has  no  affect  on  CTRL/C  in  Command  Mode. 

Execution  Mode 

If  you  have  set  CONTROL_C  NO,  then  CTRL/C  gives  control  to  MCR 
and  you  receive  the  MCR  prompt  ">"  every  time  you  press  the 
RETURN  key  .^nd  "MCR>"  every  time  you  press  CTRL/C  until  the 
exercise  has  terminated.  With  CTRL/C  disabled,  you  cannot 
interrupt  the  exercise  to  enter  lOX  commands.  However,  you  can 
terminate  it  with  the  MCR  ABORT  command  and  issue  other  MCR 
commands  while  an  exercise  is  in  progress. 

If  you  have  set  CONTROL  C  YES,  lOX  will  not  accept  any  Input  from 
your  terminal  except  "CTRL/C.  If  you  try  to  enter  anything  but 
CTRL/C,  you  receive  the  following  error  message  for  each  key  you 
press: 

lOX  --  Only  *C  allowed 

When  you  press  CTRL/C,  you  receive  the  lOX  prompt  instead  of  the 
MCR  prompt  and  lOX  exits  Execution  Mode  and  enters  Interactive 
Mode. 

Interactive  Mode 

You  hav   access  to  Interactive  Mode  only  If  CONTROL_C  is  enabled. 

Tn  Interactive  Moc'.e,  you  can  enter  most  lOX  commands.  The  RETURN 

key  and  CTRL/C  have  the  same  functions  in  Interactive  Mode  that 
they  have  In  Command  Mode. 

Section  4.9  describes  the  three  lOX  operation  modes  in  detail. 

The  initial  default  is  CONTROL  C  YES. 
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DRNSITY  is  a  devi ce-J«p«ndent  parameter  command  and  i  display  command. 
The  DENSITY  command  applies  only  to  magnetic  tape  testing  and  requires 
a  magnetic  tape  device  specification  for  "dduu:". 

You  u&e  DENSITY  as  a  device-dependent  parameter  command  with  an 
argument  "n"  to  set  the  density  and  characteristic  word  of  a  magnetic 
t«pe.  (The  device  character  1st ic  word  is  'lefined  in  the  RJ5X11M  Guide 
to  Wr  1 1  ing  an  I/O  Dt'iver  . )  You  issue  the  DENSITY  commantf  before  you 
select  the  tape  for  NFS  testing  with  SELECT.  You  can  also  set  the 
tape  density  for  a  magnetic  tape  unit  by  using  the  DENSITY  command 
within  the  SELECT  command  line. 

You  set  all  tape  densities  in  bits  per  inch  (bpi)  using  decimal  values 
for  "n".   The  following  tape  densities  are  legal: 

MF:      HM:      MS:      MTt 

ifioo    flon    ifoo    2CC 

1250     1600  55fi 

800 

You  use  DENSITY  as  a  display  command  without  an  argument  "n"  to 
displny  the  current  density  of  the  specified  magnetic  tape  unit.  For 
example: 

IOX>nENf;iTY  MM: 

Density-  1«00  BPI  Characteristic  Word-  004004  (octal) 

This  command  line  displays  the  current  density  and  characteristic  word 
for  MMO:.   To  change  the  tape  density  to  800,  you  type: 

IOX>DRN?;iTY  MM:  Rno 

The  DENSITY  command  is  the  only  way  you  can  find  out  what  the  current 
DENSITY  setting  is  on  a  magnetic  tape,  because  DENSITY  is  not 
displayed  by  the  PARAMETERLIST  command. 

To  display  the  new  tape  density  and  characteristic  word  for  MMO:,  you 
type: 

iox>df:nsity  mm: 

Denslty=  800  BPI  Characteristic  Word-  000000  (octal) 

For  tapes  other  than  MT,  MM,  MS,  and  MF,  you  enter  the  density  in 
decimal  but  lOX  displays  the  density  in  octal  as  the  characteristic 
word.   For  example: 

IOX>nF:NS  M?: 

Density-  ????  BPI     Characteristic  Word-  004004  (octal) 

iox>r)ENF;  MQ:  «nn 

IOX>nFNS  MO: 

Density-  ????  BPI     Characteristic  Word-  001440  (octal) 
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This  command  sequanco  indicates  that: 

•  lOX  does  not  know  the  density  of  the  tape  designated  as  MQ:. 
The  characteristic  word  is  the  default. 

•  When  you  set  the  density  of  MQ:  to  900  bpi  (decimal)  and 
display  the  current  density  and  characteristic  word,  the 
density  appears  in  the  characteristic  word  (octal). 

Except  for  MT:   devices,  the  initial  dnfault  density  for  magnetic  tape 
devices  is  I'iOO  bpi.   The  initial  default  for  MT:   devices  is  800  bpi. 
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DESELECT  is  an  lOX  function  command.  You  use  DESELECT  to  "deselect" 
devices  that  you  have  selected  for  testing  with  SELECT,  VERIFY,  or 
PILESll.   DESELECT  requires  device  (dd)  and  unit  (nn)  specifications. 

If  you  issue  the  DESELECT  command  in  Interactive  Mode  (while  testing 
of  the  specified  device  is  in  progress),  testing  on  the  device 
terminates  and  the  device  is  removed  from  the  list  of  devices  to  be 
tested.  If  you  issue  the  command  in  Command  Mode  (while  no  testing  is 
in  progress),  then  DESELECT  only  removes  the  device  from  the  list  of 
devices  to  be  tested. 

For  devices  that  you  have  selected  for  NFS  testing,  DESELECT  does  the 
following : 

e   Terminates  I/O  operations  (if  they  are  in  progress) 

e   Deletes  the  badblocks  list  associated  with  the   device   (disks 
only) 

e   Deallocates  all  buffer  snace 

e   Detaches  lOX  from  the  device 

Foi  devices  that  you  have  selected  for  PILESll  testing,  DESELECT  does 
the  following: 

e   Terminates  I/O  operations  (if  they  are  in  progress) 

e   Closes  and  deletes  the  temporary  file 

e   Deallocates  all  buffer  space 

The  DESELECT  command  does  not  remove  a  device  from  the  test 
configuration. 
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ERfRORLIMTTl  n 


ERRORLIMIT  is  a  device-dependent  parameter  command  that  sets  the 
maximum  number  of  errors  that  lOX  will  tolerate  between  Interval 
reports  before  deselecting  a  device. 

You  use  the  SUMMARYTIME  command  to  determine  how  often  lOX  generates 
Interval  reports.  If  you  request  interval  reports  every  two  minutes 
(SUMMARYTIME  7.)  and  set  ERRORLIMIT  at  10  errors,  lOX  will  allow  not 
more  than  10  errors  on  a  device  in  a  two-minute  interval  before 
deselecting  the  device  from  testing. 

You  can  also  use  the  ERRORLIMIT  command  within  the  FILESll,  SELECT, 
and  VERIFY  command  lines  to  override  the  default  error  limit  for  the 
device  being  selected  for  testing. 

The  Initial  default  is  10  errors. 
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EXECUTE  Is  a  function  command.  You  use  EXECUTE  to  direct  a  command 
line  to  the  operating  system  for  execution.  The  task  you  want  to  run 
must  be  installed.  For  the  EXECUTE  command  to  operate,  your  system 
must  support  task  spawning.  The  rules  for  using  the  SPWN$  directive 
and  entering  command  lines  apply  to  the  arguments  for  taskname  and 
commandstring  in  the  EXECUTE  command  line  (see  the  RSX-llM/M-PLUS 
Executive  Reference  Manual) . 

When  you  Issue  the  EXECUTE  command  in  Interactive  Mode  (testing  in 
progress),  the  task  you  have  initiated  with  EXECUTE  runs  immediately. 
When  you  issue  the  EXECUTE  command  in  Command  Mode  (no  testing  in 
progress),  lOX  queues  the  task  for  execution.  The  task  begins 
executing  when  you  start  an  exercise  with  the  START  command. 

Tasks  you  initiate  with  EXECUTE  run  in  parallel  with  I/O  exercises. 
For  example,  you  use  the  EXECUTE  command  to  run  the  BAD  utility  to 
list  at  your  terminal  the  bad  blocks  on  an  NFS  disk.  You  can  then 
enter  this  information  in  the  lOX  badblocks  list  so  that  lOX  does  not 
try  to  perform  I/O  operations  on  the  blocks  that  are  bad. 

To  run  the  BAD  utility  on  NFS  disk  DLO:,  type 

IOX>EXE  ...RAD  IDLO:/LI 

In  this  case,  you  must  include  the  pound  sign  (I)  as  shown  in  the 
command  line.  For  tasks  such  as  BAD  whose  command  line  processing 
requires  a  leading  space,  lOX  converts  the  pound  sign  to  a  space.  A 
task  such  as  PIP  does  not  require  a  leading  space  in  its  command  line. 
For  these  tasks  you  do  not  need  to  include  the  pound  sign  in  the 
command  line. 

You  can  also  use  the  EXECUTE  command  to  run  a  task  to  do  system 
testing  while  lOX  is  doing  I/O  testing.  For  example,  if  you  have 
written  a  CPU  exerciser  task  and  installed  the  task  as  ...QWK,  then 
you  can  run  this  task  in  parallel  with  the  I/O  Exerciser  by  entering 
the  command  line 

IOX>EXECUTE  ...OWK  /CPU=1144 
IOX>START 

where  /CPU=1144  is  the  command  line  to  be  passed  to  task  ...QWK. 

To  remove  a  task  from  the  list  of  tasks  to  be  executed  and  terminate 
execution  of  the  task  (if  the  task  is  in  progress),  you  use  the  ABORT 
command . 
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EXIT  Is  a   control  command.   You  use  the  EXIT  command  to  terminate   lOX 
processing  and  exit  from  lOX  to  the  operating  system  monitor. 
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P(ilesll]  dduu:   [command-quAl I f ler]  ... 

FlLESll  is  a  function  command.  You  use  PILGSll  to  select  a  Files-11 
disk  for  an  I/O  exercise.  Testing  a  disk  with  PILESll  protects  the 
contents  and  structure  of  the  disk,  because  lOX  writes  into  i 
temporary  file  that  lOX  removes  from  the  disk  at  the  end  of  the  test 
You  must  first  configure  the  disk  if  it  is  not  already  in  the  test 
configuration  before  you  can  select  It  for  testing. 

When  you  select  a  disk  using  FILSSII,  you  can  override  the  default 
parameters  by  using  the  following  device-dependent  parameter  commands 
in  the  PILESll  command  line: 

COMPAREDATA 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

TEMPORARYPILE 

The  following  example  uses  some  of  them. 

I0X>FILES11  DBO:   COMPAHEDATA»YES  RAMDOM'NO  TEMPORARYFILi;-600 

This  command  line  selects  DBO:  for  I/O  exercising.  lOX  compares  data 
read  with  data  written,  sequentially  accesses  the  blocks  in  the  file, 
and  opens  a  600-block  temporary  file.  Example  4-1  in  Section  4.7 
illustrates  and  di£.cusses  how  you  test  an  RL02  with  PILESll. 

Once  you  have  selected  a  device,  the  default  parameters  for  that 
device  are  fixed.  You  cannot  reset  them  without  first  deselecting  the 
device . 

When  you  issue  the  PILESll  command  in  Interactive  Mode  (while  an 
exercise  is  in  progress),  lOX  begins  testing  the  specified  device 
immediately.  When  you  issue  the  FILESll  command  in  Cor.mand  Mode 
(while  no  exercise  is  In  progress),  lOX  includes  the  specified  device 
in  its  list  of  devices  to  exercise  but  does  not  begin  the  exercise 
until  you  start  the  exercise  with  the  START  command. 

If  no  commands  are  specified  within  the  FILESll  command  line,  the 
device  is  exercised  with  the  default  parameters  currently  in  effect. 
Commands  car  only  be  separated  by  spaces  or  tabs. 
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H(BLP] 

HELP  is  a  display  command.   You  type  Hi^LP  to  display  a  summciry  of   lOX 
com:^Ands  at  your  terminal. 
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KNTERLEAVEl  number 

INTERLEAVE  is  a  parameter  command  that  sets  a  device-dependent 
parameter  for  disk  teatlny.  The  INTERLEAVE  command  sets  the  number  of 
blocks  to  be  skipped  before  lOX  writes  the  next  buffer  of  data.  The 
INTERLEAVE  factor  applies  only  to  sequential  testing:  that  Is,  If  you 
have  set  RANDOM  NO.  If  you  have  set  RANDOM  YES,  lOX  tests  blocks  on 
the  disk  randomly  and  ignores  the  INTERLEAVE  factor.  The  initial 
default  for  RANDOM  is  RANDOM  YES. 

You  can  use  the  INTERLEAVE  command  within  the  FILESII,  SELECT,  and 
VERIFY  command  lines  to  override  the  current  default  for  the  disk 
being  selected. 

The  initial  default  Is  four  blocks. 
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L[0GFILE1  Y(J:sl/Nroi 

LOGFILE  is  a  general  parameter  command.  You  use  the  LOGFILE  command 
to  direct  activity  and  error  Reports  either  tj  your  terminal  or  to  a 
log  fllR  in  your  default  disk  area.  Section  4.10  discusses  the 
content  and  format  of  activity  and  error  reports  in  detail. 

LOGFILE  NO  directs  activity  and  erior  reports  to  your  terminal. 
LOGFILE  YES  directs  activity  and  error  reports  to  the  log  file. 
Summary  reports,  which  lOX  generates  when  you  issue  the  PRINTSUMMARY 
command,  are  displayed  at  your  terminal  regardless  of  how  you  have  set 
LOGFILE. 

lOX  does  not  open  a  new  log  file  each  time  you  run  an  exercise  with 
LOGFILE  enabled.  It  creates  the  file  when  you  first  run  an  exercise 
and  then  appends  to  It.   The  file  is  in  your  area  and  is  named: 

yyyyyy.LOG 

where  yyyyyy  Is  the  name  of  the  task  currently  running  lOX  on  your 
terminal  (lOX,  another  task  name,  or  the  name  of  your  terminal,  for 
example  TTIO) . 

In  addition  to  activity  and  error  reports,  lOX  Inserts  the  following 
date  and  time  Information  into  the  log  file: 

•  When   the   exercise   began   followed   by   the  output   of   the 
PARAMETERLIST  command 

•  When  the  exercise  ended 

•  When  a  log  file  was  started 

•  When  log  file  entries  were  terminated 

•  When  an  exercise  was  aborted 

For  example,  all  exercises  begin  with  an  event  line  such  as: 

lOX  ~  20-JUL-81  11:15:24  ********  EXERCISER  STARTED  ******** 

and  end  with  an  event  line  such  as: 

lOX  —  20-JUL-81  11:20:34  ********  EXERCISlR  TERMINATED  ******** 

The  initial  default  Is  LOGFILE  NO. 
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PAR[AMETERLIST1 

PARAMETERLIST  is  a  display  command.   PARAMETERLIST  displays   at   least 
two  kinds  of  Information.   For  example: 


IOX>PARAMETKHLIST 

BUFFERSIZE-  \07.A. 
ERRORLIMIT-  10. 
INTERLEAVE-  4. 
PATTERN-  0. 
RECORDS-  1024. 
RUNTIME-  5. 
SUMMARYTIME-  1. 
TKMPORARYFILE-  500. 


COMPAREDATA-  YES 

CONTROL_C-'  YES 

LOOKILE-  NO 

RANDOM-  YES  . 

REPORTERRORS-  YES       )  O 

RETRIES-  YES 

VOLUMECHECK-  YES 

WAIT-  YES 

WRITECHECK-  NO        ^ 


Buffer  space  usage-  3290. : 1924 .: 1924.  :  1 .  ^ 

O  The  current  default  parameters 
9  lOX  buffer  space  statistics 

At  most,  PARAMETERLIST  displays  four  kinds  of  information: 

•  Current  execution  default  parameters 

•  lOX  buffer  space  statistics 
lOX  may  also  list  the: 

•  List  of  tasks  initiated  by  the  EXECUTE  command 

•  Devices  selected  for  testing  with  FILESll,  SELECT,  and  VERIFY 

Example  4-5  describes  the  information  in  the  four  parts  of  the 
PARAMETERLIST  display  that  correspond  to  these  four  kinds  of 
Information. 

Example  4-5   PARAMETERLIST  Display  Shown  in  Four  Parts 


IOX>EXECUTE  ...BAD  •DLO:/LI 

IOX>FILESn  SY:  TEMPORARYFILE«800  ERR0RLIMIT=50 

IOX>SELECT  hHO:  REC0RDS=»350  BUFFERSI  ZE  =  700  RETRIES  =  NO 

IOX>VERIFY  DHO:  RANQE  200:i000  RANDOHoNO  INTERLEAVE^Q 

IOX>PARAHETERLIST 


o 


Device   Mode   Buffersize   File«lz»/Records/Rand»   Parsiketers 


DHO: 

VFY 

1024. 

200. 

->    1.000. 

HHO: 

SEL 

700. 

350. 

8Y0J 

Fll 

Si2. 

800. 

RET  INT=8.  tRR"10.  Q 

COM  ERR-10. 

COM  RET  RAN  ERR=50.  O   y 


(continued  on  next  page) 
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Example  4-S  (Cont.)   PARAMETERLIST  Display  Shown  In  Four  Parts 


Task    Status 
...BAD   QUEUED 


Coaaand  lina 
DLOi/LI 


} 


tUFFERSIZE-  1024. 
ERRORLIHIT-  10. 
INTERLEAVE-  4. 
PATTERN-  0. 
RECORDS-  1024. 
RUNTIHE-  S. 
8UHNARYTIHE-  1. 
TEMPORARYFILE-  500. 


CONPARFOATA"  YES 
CONTROL. C-  YES 
LOGFILE-  NO 
RANDOM-  YES 
REPORTERRORS-  YES 
RETRIES-  YES 
VOLUHECHECK-  YES 
UAIT-  YES 
URITECHECK-  NO 


>o 


Buffi 


r-  5338. :i020. :i58e. !2. 


e 


Current  defaults  at  the  time  you  entered  the  PARAMETERLIST 
command.  None  of  the  defaults  have  been  changed  by  the 
command  sequence  in  the  example.  These  are  the  initial 
default  parameters.  You  can  alter  the  default  for  these 
parameters.  See  the  description  for  the  appropriate  command 
in  this  section. 

lOX  buffer  space  statistics.  The  form  of  these  statistics 
is  the  following: 

totalmemory: freeb lock : freebytes; fragments 
totalmemory 

Size  of  lOX  buffer  space  in  bytes. 

f reeblock 

Size  of  the  largest  free  block  of  lOX  buffer   space   in 
bytes. 

freebytes 

Total  amount  of  free   bytes   available   in   lOX   buffer 
space. 

fragments 

Number  of  memory  fragments  in  lOX  buffer  space. 

In  the  examples,  these  statistics  have  changed  to  reflect 
the  buffer  allocations  for  the  three  devices  that  you 
selected  for  testing. 

Selected  devices  and  their  device-dependent  parameters. 
These  parameters  correspond  to  the  default  parameters  unless 
you  have  overridden  the  defaults  in  the  command  line  that 
you  used  to  select  the  devices. 
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This  part  of  the  display  has  five  fields  that  are  labeled  by 
function.   They  arei 

devlc* 

Device  mnemonic  of  the  selected  device. 

node 

Testing  mode  selected,  either  VERIFY  (VFY) ,  SELECT 
(SEL) ,  or  FILESll  (Fll) . 

buf fersize 

Buffersize  used  for  reading  data  from  the  device  and 
writing  data  to  the  device.  You  can  alter  the 
buffersize  for  magnetic  tapes,  NFS  disks,  and 
cassettes.  Flles-11  disks  have  a  fixed  buffersize  of 
512.  bytes.  DECtapes  have  a  fixed  buffersize  of  1024. 
bytes. 

f lies! ze/ records/range 

One  of  the  following: 

•  Temporary  file  size  in   blocks   for   disks   selected 
with  FILESll. 

•  Number  of  records  to  test   for   magnetic   tapes   and 
cassettes  selected  with  tht,-  SELECT  command. 

•  Range  of  blocks  to  be  tested  on  NFS  disks   that   you 
selected  with  the  SELECT  or  VERIFY  command. 

parameter 

Device  dependent  parameters.  These  either  specify  a  value, 
such  as  INT=8.  or  ERR=10.  (INTERLEAVE  8  or  ERRORLIMIT  10), 
or  their  presence  indicates  that  you  have  set  a  YES/NO 
parameter  to  YES.  For  example,  in  (4)  RAN  means  that  you 
set  RANDOM  YES;  and,  in  (6),  the  absence  of  RAN  means  that 
you  set  RANDOM  NO.  See  Section  4.6  for  a  list  of  what 
parameters  apply  to  what  devices  and  modes  of  testing. 

^  This  display  line  corresponds  to  the  command  line  discussed 
next . 

0  This  is  the  command  line  that  you  used  to  select  SY:  for 
FILESll  testing,  overriding  the  TEMPORARYFILE  and  ERRORLIMIT 
defaults.  lOX  tests  SY:  as  a  Files-11  device,  using  a 
512-byte  data  buffer  (fixed)  and  a  TEMPORARYFILE  size  of  800 
blocks,  with  COMPAREDATA  enabled  (by  default),  RETRIES 
enabled  (by  default) ,  RANDOM  YES  (by  default) ,  and  an  error 
limit  of  50  errors. 

0  The  display  line  corresponding  to  the  command  line  discussed 
next. 
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0  The  command  line  you  used  to  select  DMO:  with  VERIFY.  tOX 
tests  DMO:,  using  the  VERIFY  mode  with  the  default 
bufferslze  of  1024.  bytes,  over  the  range  of  blocks  200 
through  1000,  with  RETRIES  enabled  (by  default),  RANDOM 
disabled,  the  INTERLEAVE  factor  set  to  8,  an''  the  default 
error  limit  of  10. 

O  The  list  of  tasks  Initiated  by  the  EXECUTE  command 
corresponding  to  the  command  line  discussed  next. 

This  part  of  the  display  has  the  following  fields: 

•  Task  Installed  —  taskname  (...BAD) 

•  Status   Execution  --  status   (QUEUED,   ACTIVE,    SUCCESS, 
WARNING,  ERROR,  SEVERE  ERROR) 

•  Command  Line  --  line  passed  to  the  task 

O   The  command  line  you  used  to  execute  the  BAD  utility. 

In  Command  Mode  yju  can  use  CTRL/0  to  suppress  the  output  of 
PARAMETERLIST.  In  Interactive  Mode,  CTRL/0  has  no  affect  on  the 
output. 
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PATTERN  Is  a  general  parameter  command  and  a  display  command.  You  use 
PATTERN  as  a  parameter  command  (with  an  argument)  to  set  the  pattern 
that  lOX  writes  and  reads  during  I/O  testing.  The  PATTERN  display 
command  (with  no  argument)  displays  all  13  patterns  and  shows  the 
pattern  that  Is  the  current  default  with  an  asterisk  (*). 

The  following  example  Illustrates  the  default  pattern  when  you  use 
PATTERN  as  a  display  command: 

iox>pattf:rn 

0  ■  Random  Data    * 

1  -  000000,000000 

2  "  177777,177777 

3  ■  125252,052525 

4  -  1*;55S5, 133333 

5  -  16  3126, lfi3 126 

6  «  055555,155555 

7  =.  022222,122222 

8  -  111111,111111 

9  »  007417,007417 

10  =  021042,021042 

11  «  104210,104210 

12  =  052652,052652 

To  change  the  default  p^ttern  from  random  data  to  "125252,052525", 
which  is  pattern  3,  you  type: 

IOX>PATrERN  3 

Using  the  display  form  of  PATTERN  now  shows  that  the  asterisk  moved 
from  pattern  0  to  pattern  3  after  you  changed  the  default: 

TOX>PATTERN 

0  =  Random  Data 

1  »  000060,000000 

2  »  177777,177777 

3  «  125252,052525  * 

4  =  165555,133333 

5  -^  163126,163126 

6  =  055555,155555 

7  =  022222,122222 

8  =>  111111,111111 

9  =  007417,007417 

10  =  0210-i2, 021042 

11  =  104210,104210 

12  =  052652,052652 

The  form  of  the  PATTERN  command  that  changes  the  pattern  default  is 
valid  only  in  Command  Mode. 

Pattern  0  is  random  data  from  pure  portions  of  the  I/O  Exerciser 
itself.  When  you  use  the  random  data  pattern,  the  buffersize  should 
never  exceed  3400.  bytes  or  lOX  will  generate  unpredictable  data 
compare  errors. 

The  initial  default  pattern  is  random  dtita,  pattern  0. 
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PRINTSUMMARY 


PRIfNTSUMMARYl 

PRINTSUMMARY  la  a  display  command  that  Is  valid  only  In  Interactive 
Mode. 

lOX  outputs  activity  reports  and  error  reports.  Activity  reports 
summarize  lOX  processing  Information,  such  as  how  long  an  exercise 
will  run  and  how  many  ASTs  have  been  executed.  There  are  three  kinds 
of  activity  reports:  accumulated  totals,  interval  reports,  and 
summary  reports.  (For  a  complete  description  of  these  three  kinds  of 
activity  reports,  see  Section  4.10.) 

Summary  reports  and  interval  reports  have  the  same  content  and  format. 

However,  lOX  generates  interval  reports  at  the  time  intervals  that  you 

have  set  with  the  SUMMARYTIME  command.   lOX  generates  summary  reports 

when   you  enter   the   PRINTSUMMARY  command   in   'nteractive  Mode.   A 

summary  report  summarizes   lOX  activity  between   the   last  inter"al 

report  and  the  time  you  enter  the  PRINTSUMMARY  command.  TOX  displays 
summary  reports  at  your  terminal  even  if  LOGFILE  is  enabled. 
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PROCEED 

PR0(CEED1 

PROCEED  la  a  control  command  that  you  use  only  In  Interactive  Mode. 
(Section  4.9  describes  the  three  lOX  operating  modes  In  detail.)  When 
you  enter  the  PROCEED  command,  lOX  exits  Interactive  Mode,  enters 
Execution  Mode,  and  checks  for  lOX  activity.  If  no  exercises  are  In 
progress  and  no  tasks  Initiated  by  lOX  are  executing,  then  lOX 
terminates  the  exercise. 

If  there  Is  activity,  lOX  resumes  display  of  activity  and  error 
reports  to  your  terminal  if  you  have  set  LOGFILE  NO.  (With  LOGFILE 
disabled,  lOX  suspends  activity  and  error  reports  to  your  terminal  In 
Interactive  Mode.  With  r.OGFILE  enabled,  lOX  continues  recording 
activity  and  error  reports  In  the  log  file.) 

Use  the  PROCEED  command  only  If  you  want  lOX  to  terminate  an  exercise 
as  soon  as  activity  terminates  or  if  you  want  lOX  to  resume  display  of 
activity  and  error  reports  at  your  terminal  with  LOGFILE  disabled. 
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RANDOM 


RANnfOMI  Y[ES1/N(0l 

RANDOM  la  a  device-dependent  parameter  command  that  applies  to  disk 
testing.  The  RANDOM  command  directs  lOX  to  select  either  random  or 
sequential  blocks  for  disk  testing. 

RANDOM  YES  directs  lOX  to  use  its  random  number  generator  to  choose 
the  blocks  on  the  selected  disk  for  exercising.  RANDOM  NO  directs  lOX 
to  sequentially  test  blocks  on  the  disk. 

If  you  set  RANDOM  NO,  then  lOX  skips  the  number  of  blocks  specif  ltd 
with  the  INTERLEAVE  command  before  testing  the  next  block.  For 
example: 

IOX>INTF;Rr,RAVE  8 
TOX>nANDOM  NO 

In  this  example,  TOX  tests  every  eighth  block  on  the  disk  (that  is, 
block  0,7,15,.   .   .   . )  . 

You  can  use  the  RANDOM  command  within  the  FILESll,  SELECT,  and  VERIFY 
command  lines  to  override  the  current  default  parameter  for  selecting 
blocks  for  testing. 

The  initial  default  Is  RANDOM  YES. 
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RANGE 

RANG(E1  dduu:   [minltnumtmaximum] 

RANGE  is  a  iev Ice-dependent  parameter  command  and  a  display  command. 
The  RANGE  coi.imand  applies  only  to  disks  that  you  have  selected  for  NFS 
testing  with  SELECT  or  VERIFY. 

RANGE  as  a  parameter  command  sets  the  minimum  and  maximum  block 
numbers  for  NFS  testing  on  the  specified  disk  unit.   For  example: 

IOX>RANGE  DLO:   300:500 

lOX  tests  blocks  in  the  range  300  through  500  on  DLO.  This  form  of 
the  RANGE  command  can  be  used  in  the  SELECT  or  VERIFY  command  lines  to 
specify  the  range  of  blocks  to  be  tested. 

RANGE  as  a  display  command  displays  the  current  range  of  blocks  to  be 
tested  on  the  specified  disk  unit.  The  device  must  have  been  selected 
for  testing. 

For  example: 

IOX>RANGE  DLO; 
0.  ->  20,420. 

This  is  the  default  for  RL02!i.  After  you  issue  the  RANGE  command  in 
the  previous  example,  you  can  use  the  RANGE  command  to  display  the 
current  range  of  blocks  to  be  tested: 

IOX>RANGE  DLO: 
300.  ->  500. 

This  form  of  the  RANGE  command  cannot  be  used  within  the  SELECT  or 
VERIFY  command  lines. 

The  default  range  for  all  disks  that  have  been  selected  is  zero  to  the 
maximum  block  number  on  the  disk  minus  sixty  (0 :maximum-60) . 
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RECORDS 


RECtORDS]  recordcount 

RECORDS  Is  a  device-dependent  parameter  command  that   applies 
testing    of   magnetic   tapes   and   cassettes   with   SELECT, 
specifies  a  recordcount,   which   Is   the   number   of   records 
magnetic  tape  or  cassette  to  be  exercised.   For  example: 

IOX>RECORDS  200 


to  the 
RECORDS 
on   the 


This  command  line  direc<:s  lOX  to  exercise  200  records  on  all  magnetic 
tapes  and  cassettes.  RECORDS  C  directs  lOX  to  test  the  records  on 
magnetic  tapes  and  cassettes  until  it  detects  the  end  of  the  tape,  at 
which  time  lOX  displays  an  »nd  of  tape  message  and  deselects  the  tape 
unl  t . 

You  can  use  RECORDS  in  the  SELECT  command  line  to  override  the  default 
recordcount  for  the  magnetic  tape  or  cassette  being  selected. 

The  initial  default  is  1024.  records. 
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REPORTERROhS 

REP[0RTERR0RS1  Y(ER1/N(01 

REPORTERRORS  is  a  general  parameter  comnand  that  you  use  to  enable 
(REPORTERRORS  YES)  or  disable  (REPORTERRORS  NO)  lOX  error  reports. 
There  are  two  kinds  of  error  reports:  data  compare  error  reports  and 
I/O  err  >r  reports. 

If  a  succ  ss  code  Is  returned  from  the  device  driver  (meaning   that   a 

QIO   succeeded)   but  the   data  that  lOX  wrote  does  not  match  the  data 

that  lOX  read,  then  a  data   compare   error   has  occurred.    Section 

4.10.2.1  illustrates  and  discusses  data  compare  error  reports. 

I/O  error  codes  are  returned  from  the  device  drivers  (meaning  that  a 
QIO  failed).  These  error  codes  generate  one  of  12  error  messages 
discussed  in  Sections  4.10  and  4.13. 

lOX  directs  error  reports  to  your  terminal,  but  with  the  following 
restrictions: 

•  Error  reports  never  interrupt  activity  reports. 

•  If  LOGFILE  is  enabled,  lOX  enters  error   reports   in   the   log 
file  instead  of  displaying  them  at  your  turminal. 

•  In  Interactive  Mode,  lOX  suppresses   the   printing   of   error 
reports. 

The  Initial  default  is  REPORTERRORS  YES. 


m 
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RESTART 


RESfTART] 

RESTART  is  a  control  command.  The  RESTART  command  is  valid  only  in 
Command  Mode.  When  you  restart  the  I/O  Exerciser,  you  effectively 
reinvoke  lOX  without  e^ritinq  to  the  operating  system  monitor. 

The  RESTART  command  performs  the  following  functions: 

•  Deselects  devices  that  are  selected  for  testing. 

•  Resets  all  parameters  to  their  initial  defaults. 

•  Removes  all  tasks  queued  for  execution  by  the  EXECUTE   command 
from  the  list  of  tasks  to  be  executed. 

•  Unconfigures   all   devices   that   you   =«dded   to   the   default 
configuration. 


4-53 


THE    I/O    EXERCISER    (lOX) 

RETRIES 

RETCRlt'Sj  V[ES1/N[0] 

RETRIES  is  a  device-dependent  parameter  command  that  applies  to  the 
testing  of  magnetic  tapes  and  NFS  disks.  RETRIES  YES  directs  a  device 
driver  to  use  its  standard  recovery  techniques  to  attempt  to  recover 
from  an  error.  RETRIES  NO  inhibits  an  I/O  driver  from  using  its 
standard  recovery  techniques  wh-5.i  it  encounters  an  error. 

You  can  use  the  RETRIES  command  within  the  SELECT  and  VERIFY  command 
lines  to  override  the  current  default  for  the  device  being  selected. 

The  initial  default  is  RlTRIES  YES. 
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RUNTIME 


RUN[TIME]  minutes 

RUNTIME  is  a  general  parameter  command. 
Command  Mode  (nc  exercising  in  progress) 


RUNTIME   is   valid   only   in 


You  use  the  RUNTIME  command  to  specify  how  many  -ninutes  you  wanL  lOX 
to  test  the  devices(s)  that  you  have  selected  for  testing.  If  you 
specify  RUNTIME  0,  lOX  continues  testing  the  selected  devices  until 
you  abort  the  exercise  with  either  the  lOX  ABORT  command  or  the  MCR 
ABORT  command. 

The  initial  default  is  five  minutes. 
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SELECT 


SEfLECT]  dduu:   [command=qual i f ier]  .... 

SELECT  is  a  function  command.  The  SELECT  command  selects  a  device 
with  an  NFS  volume  mounted  for  an  I/O  exercise  that  destroys  the 
contents  and  structure  of  the  volume.  Before  using  select,  you  must 
first  configure  the  device  if  it  is  not  in  the  test  configuration. 

When  you  use  the  SELECT  command  to  select  a  device  to  be  tested  as  an 
NFS  volume,  you  can  ovarride  the  current  default  parameters  by  using 
the  commands  in  Tab^e  4-3  within  the  SELECT  command  line. 


Table  4-3 
Parameter  Commands  by  Device  Type  for  the  SELECT  Command 


NFS  Disks 

Cassettes 

DECtapes 

Magnetic 

Tapes 

BUFFERSIZE 

BUFFERSIZE 

COMPAREDATA 

BUFFERSIZE 

COMPAREDATA 

COMPAREDATA 

ERRORLIMIT 

ERRORLIMIT 

ERRORLIMIT 

ERRORLIMIT 

DENSITY 

INTERLEAVE 

RECORDS 

RECORDS 

RANDOM 

RETRIES 

RANGE 

RETRIES 

VOLUMECHECK 

WRITECHECK 

The  following  command  line  illustrates  some  of  these  commands: 

IOX>SEL  DLO:   RANG=1 00 : 4000  RET=YES  RAND=NO  INT=8  BUF=2000 
This  command  line: 

•  Selects  DLO:   for  I/O  exercising 

•  Tests  only  blocks  100  through  4000 

•  Allows  the  driver  to  retry  I/O  operations   if   it  encounters 
errors 

•  Accesses  the  blocks  on  the  volume  sequentially  testing   every 
eighth  block 

•  Uses  a  data  buffer  of  2000  bytes  for  data  transfer. 

Example  4-2  in  Section  4.8.1  illustrates  and  describes  how  you  test  a 
magnetic  tape  unit  with  the  SELECT  command. 
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SELECT  (Cont.) 


Once  you  have  selected  a  device,  the  default  parameters  for  that 
device  are  fixed.  You  cannot  reset  them  without  first  deselecting  the 
device. 

When  you  issue  the  SELECT  command  in  Interactive  Mode  (while  an 
exercise  is  in  progress),  lOX  begins  testing  the  specified  device 
immediately.  When  you  issue  the  SELECT  command  in  Command  Mode  (while 
no  exercise  is  in  progress),  TOX  includes  the  specified  device  in  its 
list  of  devices  to  exercise  but  dot's  not  begin  the  exercise  until  you 
start  the  exercise  with  the  STAf^T  command. 

If  no  further  parameter  commands  are  specified  within  the  SELECT 
command  line,  the  device  is  exercised  with  the  parameters  currently  in 
effect.   Commands  can  only  be  separated  by  spaces  or  tabs. 


• 
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SPY 

SPTY]  [dduu!l 

SPY  is  a  display  command.  You  issue  tho  aPY  command  only  In 
Interactive  Mode  (exercising  in  progress)  to  display  status 
information  on  device(s)  being  tested. 

SPY  without  an  argument  displays  status  information  on  all  devices 
being  tested.  SPY  with  a  device  and  unit  specification  displays 
status  information  only  on  the  specified  device.   For  example: 

>SPY  DBG: 

lOX  outputs  the  following: 

DBO:   —  TYPE=F11    VBN«305.    I/0=AST    queued    FUNCTION=WRITE 
This  output  indicates: 

•  Device  being  exercised  (DBO:) 

•  Type  of  testing   being   performed   on   tfie   device:    FILESll 
(Fll),  SELECT  (SEL) ,  VERIFY  (VFY) 

•  Virtual  block  number  being  tested  (305.   in  this  example)  or, 
for  NFS  volumes,  the  logical  block  number 


I/O  request  status:   AST  queued,  in  progress,  or  idle 
Type  of  I/O  function  being  performed:   READ  or  WRITE 
SPY  always  outputs  to  your  terminal,  even  if  LOGFILE  is  enabled. 


4-58 


THE  I/O  EXERCISER  (lOX) 

START 


STTART] 


START  IS  a  control  command.   START  is   valid   only   In   Command  Mode. 

When   you   issue   the  START  command,  lOX  exits  Command  Mode  and  enters 

Execution  Mode.  Section  4.9  discusses  the  three  lOX  operating  modes 
in  del  "i  1 .                                           <r               ^ 

After  you  have  set  your  test  configuration  and  selected  the  devices 
you  want  to  test,  you  begin  exercising  the  selected  units  with  the 
START  command.  START  also  turns  o-\  the  lOX  clock,  begins  activity  and 
error  reporting  (if  you  endbled  error  reporting  with  REPORTERRORS 
YES),  and  begins  executing  tasks  queued  by  the  EXECUTE  command. 
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SUMMARYTIME 

SU[MMARYTIME1  minutes 

SUMMARYTIME  is  a  general  parameter  command  you  use  to  specify  how 
often  (in  minutes)  lOX  outputs  interval  reports.  (See  Section  4.10 
fjr  a  complet*  discussion  of  interval  reports).  You  can  suppress 
interval  reports  by  setting  SUMMARYTIME  0. 

The  initial  default  is  one  minute. 
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TEMPORARYFILE 


T[EMPORARYFILEi  filesize 


TEMPORARYFILE  is  a  device-dependent  parameter  command  that  applies  to 
the  testing  of  Files-11  disks  with  the  FILESll  command.  The  FILESll 
thr'"?nv°r^''^^^  ""l?^  contents  of  the  disk  by  writing  a  temporary  file 
in  blocks  °   '*'^  exercise.   You  specify  the  filesize 

You  can  use  the  TEMPORARYFILE  command  in  the  FILESll  command  line  to 
override  the  current  default  for  the  disk  being  selected. 

The  initial  default  is  500  blocks. 
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VERIFY 

VEfRIFY]  dduu:   (cominancl=qual  i  f  ier  ]  .... 

VERIFY  is  a  function  command  you  use  to  select  a  mounted  NFS  disk  for 

an   exercise.    VERIFY   reads   buffers   of  data  without  writing  on  the 

disk,  performing  data  comparisons,  or  destroying  the  contents  of  the 
disk. 

VERIFY  accepts  the  following  device-dependent  parameter  commands 
within  its  command  line  to  override  the  default  parameters  for  the 
device  being  tested: 

BUFFERSIZE 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

The  following  example  illustrates  how  you  use  the  ERRORLIMIT  and  RANGE 
commands  within  the  VERIFY  command  line  to  override  the  current 
defaults  for  testing  DM0: 

IOX>VERIFY  DM0:   RANGE  1000:3000  ERRORLIMIT=1000 

This  command  line  selects  DM0:  for  read  only  testing  of  blocks  1000 
through  3000  (inclusive)  with  a  maximum  of  1000  errors  before  lOX 
deselects  the  disk.  Example  4-3  in  Section  4.8.2  illustrates  and 
explains  how  you  test  an  NFS  disk  with  VERIFY. 

Once  you  have  selected  a  device,  the  default  parameters  for  that 
device  are  fixed.  You  cannot  reset  them  without  first  deselecting  the 
device. 

When  you  issue  thft  VERIFY  command  in  Interactive  Mode  (while  an 
exercise  is  in  progress),  lOX  begins  testing  the  specified  device 
immediately.  When  you  issue  the  VERIFY  command  in  Command  Mode  (while 
no  exercise  is  in  progress),  lOX  includes  the  specified  device  in  its 
list  of  devices  to  exercise  but  does  not  begin  the  exercise  until  you 
start  the  exercise  with  the  START  command. 

If  no  further  pat^rmeter  commands  are  specified  within  the  VERIFY 
command  line,  che  disk  is  exercised  with  the  parameters  currently  in 
effect.   Commands  can  only  be  separated  by  spaces  or  tabs. 
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VOLUMECHECK 


VO[LUMECHECK]  Y[ES]/N[0] 


VOLUMECHECK 
NFS  disk 
checking  of 
Files-11  St 
lOX  will  no 
with  a  Fi 
NO) ,  lOX  wi 
without  wa 
disk.  You 
writing  ove 


IS  a  device-dependent  parameter  command   that 
testing   with   SELECT.    VOLUMECHECK   enables   o 

disks  mounted  as  NFS  volumes  for  a  home  bl 
ructure.  If  VOLUMECHECK  is  enabled  (VOLUMECHECK 
t  allow  you  to  use  the  SELECT  command  to  select 
les-11  structure.  With  VOLUMECHECK  disabled  ( 
11  allow  you  to  use  the  SELECT  command  to  select 
rning  you  that  the  test  will  destroy  the  cont 
should  use  VOLUMECHECK  YES  unless  you  are  in 
r  it   Files-11  disk. 


applies   to 

r   disables 

ock   and   a 

YES) ,  then 

a  volume 
VOLUMECHECK 

the  disk 
ents  of  the 
tentionally 


ovorr?H  ""It   ^^^   VOLUMECHECK  command  within  the  SELECT  command  line   to 
override  the  current  default  for  the  disk  beinc  selected. 

The  initial  default  is  VOLUMECHECK  YES. 
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WAIT 


WA[IT]    Y[ES]/N[0] 


• 


^^I'^rit  ^   general  parameter  command  you  use  to  determine  whether 
Catt    "^^^  °''  ^"  fr"*"  ^^^^  ''^^^^  *"  exercise  is  in  progress,   xne 
EjE^UTrcoSmand!  "°  '"'''  °"   ''^'^   ''^'   ^°"   initiated   with  the 


or 
The 


WAIT  YES  requires  lOX  to  wait  for  an  event  flag  to  signal  that  an   I/O 


The  initial  default  is  WAIT  YES, 
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WR[ITECHECK]  Y[ES1/N[0] 

WRITECHECK  is  a  device-dependent  parameter  command  that  applies  only 
to  testing  NFS  disks  with  SELECT.  You  use  the  WRITECHECK  command  to 
determine  whether  or  not  I/O  drivers  perform  write  checks  to  NFS 
disks. 

If  WRITECHECK  is  enabled,  lOX  writes  data  to  the  disks  by  issuing  an 
lO.WLC  (write  logical  block  with  check)  to  the  driver  instead  of 
lO.WLB  (write  logical  block).  This  means  that  the  disk  controller 
reads,  word-by-word,  a  copy  of  the  data  from  the  data  buffer  while 
simultaneously  r  'ing  the  same  data  from  the  disk.  The  disk 
controller  compat  the  two  copies  of  the  data.  If  the  copies  do  not 
match  and  RETRIES  is  enabled,  the  driver  repeats  the  original  write 
operation  and  performs  another  write  check.  This  process  continues 
until  the  WRITECHECK  function  succeeds  or  the  retry  count  for  the 
drivei  is  exceeded.  If  RETRIFS  is  disabled  or  if  RETRIES  is  enabled 
but  the  retry  count  for  the  driver  is  exceeded,  then  the  driver  issues 
the  hard  error  message,  lE.WCK,  and  lOX  generates  an  error  message. 

You  can  use  the  WRITECHECK  command  within  the  SELECT  command  line  to 
override  the  current  default  for  the  device  being  selected. 

The  initial  default  is  WRITECHECK  NO. 
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4.1?   ERROR  MESSAGEF 


lOX  generates  two  types  of  error  messages:  error  messages  with  device 
specifications  and  error  messages  without  device  specifications.  lOX 
displays  device  specifications  as  appropriate. 

The  format  for  an  error  message  with  a  device  specification  is: 

taskname  —  ddnn;   message 

taskname 

Name  of  the  lOX  task  that  is  currently   running.    In   the   error 
messages  that  follow,  taskname  is  always  lOX. 

ddnn 

Device  specification  text  of  the  message, 
message 

Information  specific  to  this  message. 
The  format  for  an  error  message  without  a  device  specification  is; 

taskna.ne — message 

where  taskname  and  message  are  the  same  as  defined  in  the  previous 
format . 

All  error  messages  use  the  letter  "x"  to  indicate  that  lOX  substitutes 
the  appropriate  command,  task  name,  or  value  for  "x"  within  the 
messaae. 


4.13.1   Error  Messages  with  Device  Specifications 

The  error  messages  are  presented  in  alphabetical  order   by   the   first 
letter  following  the  device  specification. 

lOX  —  dduu:   bad  block,  xxx  (decimal)  xxx  (octal) 

Explanation:  lE.BBE  error  code  returned  to  lOX  (bad  block 
error) . 

enter  the  block  number  into  the  badbiocks  list. 

lOX  —  dduu:   block  number  out  of  range 

Explanation:  You  used  the  BADBLOCKR  command  to  enter  a  block 
number  in  tne  badbiocks  list  that  is  outside  the  range  of  blocks 
that  you  specifier'  with  the  RANGE  command. 
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lOX  —  dduu:   buffer  size  Is  greater  than  default 

Bxulanation:  The  buffersize  that  you  specified  in  the  SELECT  or 
VERIFY  command  line  is  greater  than  the  current  default  set  with 
the  BUFFERSIZE  command  by  itself. 

Us«r  Action:  Either  raise  the  default  buffersize  (using 
BUFFERSIZE  by  itself)  or  lower  the  buffersize  override  for  the 
device  (using  BUFFERSIZE  within  the  SELECT  or  VERIFY  command 
line) . 

lOX  —  dduu:  data  compare  error  at  block  xxx  (decimal)  xxx  (octal) 

Good  data:  xxxxx  bad  data:  xxxxx 

Word  position:  xxx  (decimal)  xxx  (octal) 

Buffer  contained  xx .  additional  errors 

Explanation:  lOX  found  an  error  when  comparing  the  data  read 
with  the  data  written.  This  error  message  shows  the  first  block 
number  in  which  the  error  occurred  during  the  transfer,  the  good 
and  bad  data,  the  word  position  of  the  first  error  found  in  the 
buffer,  and  the  number  of  additional  errors  found  in  the  buffer. 
Section  4.10.2.1  discusses  data  compare  error  reports  in  detail. 

User  Action:  None.  If  the  error  persists,  enter  the  block  in 
the  badblocks  list  by  using  the  BADBLOCKS  command  (for  NFS  disks 
only) . 

lOX  —  dduu:   data  overrun  at  block  xxx  (decimal)  xxx  (octal) 

Explanation:  lE.DAO  error  code  returned  to  lOX  (data  overrun). 
The  record  size  given  was  greater  than  the  record  size  read. 
This  error  occurs  on  tape  devices  only. 

User  Action:   None. 

lOX  —  dduu:   dev  ce  type  not  specified  -  defaulting  to  'DISK' 

Explanation:  This  message  tells  you  that  you  are  adding  a  device 
to  your  test  configuration  with  the  CONFIGURE  command  that  lOX 
configures  as  a  disk  by  default. 

User  Act.  n:   None. 

lOX  —  dduu:   did  not  respond  -  unit  now  deselected 

Explanation:  The  unit  did  not  respond  tc  the  lOX  command  within 
one  minute.  The  device  may  have  been  accidentally  put  off  line 
or  a  tape  drive  may  have  lost  its  column  vacuum. 

User  Action:   Check  the  device. 
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lOX  —  dduu:   does  not  support  the  x  command 

Explanation:  The  x  command  Is  incompatible  with  the  device 
specification,  dduu:. 

User  Action:   None. 

lOX  —  dduu:   duplicate  block  number 

Explanation:  The  block  number  you  entered  with  the  BADBLOCKS 
command  is  already  In  the  badblocks  list  for  the  device. 

User  Action;   None. 

TOX  —  dduu:   end  of  tapa  detected  -  unit  now  deselected 

Explanation:  10. EOT  error  code  returned  to  lOX  {end-of-tape 
detected),  lOX  attempted  to  write  a  record  past  the  end-of-tape 
marker . 

User  Action:   This  is  an  informational  message  only. 

TOX  —  dduu:   error  threshold  exceeded  -  unit  now  deselected 

Explanation:  The  number  of  errors  set  with  the  ERRORLIMIT 
command  has  been  exf^eeded. 

User  Action:   None. 

lOX  —  dduu:   error  while  reading  home  block 

Explanation:  When  VOLUMECHECK  is  enabled,  this  message  occurs  if 
lOX  detects  an  error  while  attempting  to  read  the  home  block  of  a 
Files-11  device. 

User  Action:  The  disk  you  selected  may  be  defective.  If  you  are 
testing  a  scratch  disk,  select  the  disk  again  with  VOLUMECHECK 
NO. 

lOX  —  dduu:   failed  (-.o  attach 

Explanation:   lOX  could  not  attach  the  unit. 

User  Action:  The  device  may  be  mounted  or  attached  by  someone 
else.   Make  sure  you  have  allocated  and  mounted  the  device. 

For  RSXllM-PLU^  systems,  mount  devices  with  the  /FOREIGN  switch. 

lOX  —  dduu:   failed  to  detach 

Explanation:  An  error  occurred  while  lOX  was  attempting  to 
detach  a  unit  that  it  had  previously  attached. 

User  Action:   None.   This  is  a  possible  operating  system  problem. 
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lOX  —  dduii:   failed  to  open  temporary  file 

Explanation:  lOX  could  not  find  enough  free  blocks  on  the  disk 
to  open  a  temporary  file  as  large  as  the  one  you  specified  with 
the  TEMPORARYFILR  command. 

User  Action:  Specify  a  smaller  temporary  file  size  either  by 
resetting  the  default  with  the  TEMPORARYFILE  command  by  itself  or 
by  using  TEMPORARYFTLR  within  the  FILESll  command  line  to 
override  the  default  TFMPORARYFTLE  size  for  each  device. 

Tf  you  are  using  the  default  (SOO  blocks)  when  lOX  generates  this 
message,  then  you  need  to  make  room  on  the  disk. 

lOX  —  dduu:   fatal  hardware  error  -  unit  now  deselected 

Explanation:  lE.FHE  error  code  returned  to  lOX  (fatal  hardware 
error) . 

User  Action:   Check  the  hardware. 

lOX  —  dduu:   illegal  density 

Explanation:  The  density  that  you  specified  with  the  DENSITY 
command,  for  the  magnetic  tape  is  illegal. 

User  Action:  Reenter  the  command,  using  a  legal  density.  See 
Section  4.12. 

lOX  —  dduu:   illegal  range 

Explanation:  The  range  of  blocks  which  you  specified  on  the 
device  to  be  tested  with  the  RANGE  command  is  out  of  bounds. 

User  Action:  Use  RANGE  with  no  qualifier  to  check  the  default 
range  on  the  device;   then  specify  a  range  within  bounds. 

lOX  —  dduu:   invalid  block  number 

Explanation:  Th^i  block  number  that  you  entered  with  the 
BADBLOCKS  command  was  not  a  valid  block  number  for  the  device. 

User  Action:   None. 

lOX  —  dduu:   I/O  is  unsatisfied  at  timeout  -  function:   xxxx 

Explanation:  When  lOX  finishes  processing,  it  waits  five  seconds 
for  I/O  to  stop.  If  a  long  tape  has  not  finished  rewinding,  this 
message  may  occur.   The  function  that  timed  out  is  xxxx. 

User  Action:   None. 
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lOX  —  dduu:   I/O  request  aborted  -  unit  now  des>?lected 

Explanation:  IE. ABO  error  code  returned  to  lOX  (operation 
aborted) . 

User  Action:   None. 

TOX  —  dduu:   is  already  configured 

Explanation:  You  tried  to  configure  with  the  CONFIGURE  command  a 
unit  that  is  already  in  the  test  configuration. 

User  Action:  Use  the  CONFIGURE  command  as  a  display  command  to 
check  which  devices  are  configured. 

lOX  —  dduu:   is  already  selected 

Explanation:  You  tried  to  select  a  unit  that  has  already  been 
selected . 

User  Action:  Use  the  PARAMETERLIST  command  to  display 
information  on  all  units  that  are  selected. 

lOX  —  dduu:   is  not  configured 

Explanati'n:  You  issued  a  command  that  is  valid  only  for 
configured  devices. 

User  Action:   Use  the  CONFIGURE  command  to  configure  the  device. 

lOX  —  dduu:   is  not  mounted  or  allocated  for  NFS  operations 

Explanation:  You  have  selected  a  device  for  testing  with  SELECT 
or  VERIFY  that  is  not  properly  allocated  and  mounted  for  NFS 
testing . 

User  Action:   Allocate  and  mount  the  device. 

For  RSX11M--PLUS  systems,  mount  NFS  devices  with  th«  /FOREIGN 
switch. 

lOX  —  dduu:   is  not  ready  -  unit  now  deselected 

Explanation;  lE.DNR  error  code  returned  to  lOX  (device  not 
ready) . 

User  Action:   Select  the  device  again. 

lOX  —  dduu:   is  not  selected 

Explanation:  You  issued  a  device-dependent  parameter  command 
(BADBLOCKS  or  RANGE)  that  is  valid  only  after  you  have  selected 
the  device. 

User  Action:   Select  the  device;   then  reenter  the  command. 
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lOX  —  dduii:   is  offline 

Explanation:  lE.OFL  error  code  returned  to  lOX  (device  off 
Tine).  The  device  was  taken  off  line  while  testing  was  in 
progress  or  you  tried  to  select  a  device  that  was  off  line.  If 
testing  was  in  progress  on  the  device  when  it  was  taken  off  line, 
TOX  appends  "  -  unit  now  deselected"  to  the  error  message. 

User  Action:   Ensure  that  the  device  is  on  line. 

lOX  —  dduu:   is  write  locked  -  unit  now  deselected 

Explanation:  lE.WLK  error  code  returned  to  lOX  (write-lock 
error).   The  device  is  wr i te-locked . 

User  Action:  Check  the  device  wr i te-lock/wri te-enable  switch  and 
the  MCR  write-lock  status. 

TOX  —  dduu:   LUN  assignment  failure 

Explanation;  This  probably  means  that  the  device,  ddnn:,  is  not 
physically  present  in  your  system.  It  may  mean  that  you  have 
exceeded  the  number  of  devices  that  lOX  can  support.  The  default 
is  2S  devices;   the  maximum  number  of  devices  is  24'). 

User  Action:  If  the  device  is  not  physically  present  in  your 
system  then  take  no  action.  If  you  have  exceeded  the  number  of 
devices  that  lOX  can  support,  then  edit  the  Task  Builder  command 
file,  lOX.CMD  (see  Section  4.11),  to  allow  lOX  to  support  more 
devices. 

lOX  —  dduu:   privilege  violation  -  unit  now  deselected 

Explanation:  lE.PRI  error  code  returned  to  lOX  (privilege 
violation).  The  device  was  not  allocated  or  it  was  mounted  by 
someone  else. 

User  Action:   Check  the  ownership  of  the  device. 

lOX  —  dduu:   specified  device  type  is  inconsistent 

Explanation;   You  tried  to  configure  device  "dduu"  as  a  tape  when 

a   "dd"   device  had  already  been  configured  as  a  disk.   The  same 

holds  true  if  "dd"  had  already  been  configured  as  a  tape  and  you 
tried  to  configure  another  "dd"  device  as  a  disk. 

User  Action:  Use  the  CONFIGURE  command  as  a  display  command  to 
check  on  the  devices  in  your  test  configuration.  Configure  the 
unit  using  a  different  device  mnemonic. 

lOX  —  dduu:   unexpected  error  #xx 

Explanation:  lOX  received  an  I/O  error  code  that  it  could  not 
process.   The  error  code  is  xx  (octal)  . 

User  Action:   None. 
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lOX  —  drtuu:   unexpected  request  to  queue  I/O  -  reqni»»  t  aborted 

Explanation:  lOX  received  an  AST  from  a  device  after  it  had 
deselected  the  device. 

User  Action:   Check  the  device. 

lOX  —  dduu:   unrecoverable  error  at  block  xxx  (decimal)  xxx  (octal) 

Explanation;  lE.VER  error  code  returned  to  lOX  (unrecoverable 
error).   This  code  indicates  an  unrecoverable  error. 

User  Action:   Check  the  device  and  media. 

lOX  —  dduu:   VOLUMECHECK  failure.   Unit  contains  a  home  block 

Explanation:   The  unit  is   file-structured   because   the  device 

contains  a  home  block.  This  error  message  is  generated  by  select 

if  you  try  to  select  a  Files-11  volume  while  VOLUMECHECK  is 
enabled . 

User  Action:  TOX  destroys  information  on  devices  that  you  select 
for  exercising  with  the  SELECT  command.  If  you  want  to  destroy 
the  contents  of  the  disk,  disable  VOLUMECHECK  (VOLUMECHECK  NO) 
and  select  the  device  again. 

lOX  —  dduu:   write  check  error  at  block  xxx  (decimal)  xxx  (octal) 

Explanation:  lE.WCK  error  code  returned  to  lOX  (write  check 
error).   The  write  check  operation  failed  at  block  xxx. 

User  Action:   None. 


4.13.2   Error  Messages  Without  Device  Specifications 

These  error  messages  are  presented  in  alphabetical  order  by  the   first 
letter  following  the  lOX  task  name. 

lOX  —  Indirect  command  file  syntax  error 

Explanation:   There  is  an  error  in  the  indirect  command  file. 
User  Action:   Check  the  indirect  command  file. 

TOX  —  Indirect  command  file  nesting  level  exceeded 

Explanation;   lOX  accepts  indirect  command  files   with   only  one 
level  of  nesting. 

User  Action:   Rewrite  the  indirect  command  file  so  that   it  does 
not  have  more  than  one  level  of  nesting. 
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lOX  —  Aborting  due  to  user  command 

Explanation:   You  aborted  lOX  by  using  the  MCR  ABORT  command. 
User  Action:   Reinvoke  TOX  if  you  want  to  continue  testing. 

lOX  —  EXECUTE  command  is  not  supported 

Explanation:   You  attempted  to   use   the   EXECUTE   command   in   a 
system  that  does  not  support  task  spawning. 

User  Action:   Do   another   SYSGEN   if   you   require   the   EXECUTE 
command  to  properly  test  your  I/O  devices. 

lOX  —  Command  input  I/O  error 

Explanation:   lOX  detected  an  error  when  it   tried   to   read   the 
command  that  you  typed  st  the  terminal. 

User  Action:   Reenter  the  command. 

TOX  -  Command  valid  only  in  Command  Mode 

Explanation:  You  tried  to  enter  a  command  that  cannot  be  entered 
while  an  I/O  exercise  is  in  progress. 

User  Action:  Either  abort  the  exercise  and  enter  the  command  or 
wait  until  the  exercise  has  finished  to  enter  the  command. 

lOX  —  Command  valid  only  in  Interactive  Mode 

Explanation:  You  tried  to  enter  a  command  that  cannot  be  entered 
unless  lOX  is  running. 

User  Action:   Type  START;   then  reenter  the  command. 

lOX  —  Command  not  unique 

Explanation:  The  command  abbreviation  that  you  entered  did  not 
distinguish  it  from  another  command. 

User  Action:   Reenter  the  command  by  using  a  longer  abbreviation. 

lOX  —  Failed  to  close  log  file.   F.ERR=  -x 

Explanation:  lOX  could  not  close  the  log  file  in  your  dir^"tory. 
The  PCS  error  returned  was  "-x". 

User  Action:  \ook  up  the  I/O  error  code  returned  to  lOX  by  FCS 
in  the  IAS/kSX-11  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 
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lOX  --  Pailert  to  open  indirect  command  file 

Explanation:  The  PCS  GCML  routine  failed  to  open  the  indirect 
command  file. 

U>*r  Action:  check  to  see  that  the  file  exists  and  that  you 
specified  the  file  correctly;   then  resubmit  the  file  to  lOX. 

lOX  —  Failed  to  open  loq  file.   F.ERR=»  -x 

Explanation:  lOX  cou''d  not  open  the  log  file.  The  PCS  error 
returned  was  "-x". 

User  Action:  The  disk  may  be  write  protected  or  may  not  have 
enough  blocks. 

TOX  —  Failed  to  open  existing  loq  file.   F.ERR»  -x 

Explanation;  TOX  couid  not  open  a  log  file  that  already  exists 
in  your  directory.   The  PCS  error  returned  was  "-x". 

User  Action:  Look  up  the  I/O  error  code  returned  to  lOX  by  PCS 
in  the  IAS/RSX-1 1  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 

lOX  —  Failed  to  truncate/close  log  file.   F.ERR=  -x 

Explanation:  lOX  could  not  truncate  or  close  the  log  file.  The 
PCS  error  returned  was  "-x". 

User  Action:  Look  up  the  I/O  error  code  returned  to  lOX  by  PCS 
in  the  IAS/RSX-1 1  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 

lOX  —  Fatal  file  system  error.   F.ERR-  xxx  PC+2=  xxx 

Explanation:  lOX  exited  because  an  error  occurred  while  lOX  was 
trying  to  issue  a  read  or  write.  P. ERR  is  the  octal  error  code 
in  the  File  Descriptor  Block  indicating  the  kind  of  file  error. 
PC+2  is  the  octal  location  of  the  failure  in  the  lOX  code. 

User  Action:  Look  up  the  T/O  error  code  returned  to  lOX  by  PCS 
in  the  IAS/RSX-11  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 

ICX  —  Fatal  system  error.   DSW»  xxx  PC+?=  xxx 

Explanation:  lOX  immediately  exits  because  a  directive  that  10" 
issued  failed.  OSW  is  the  Directive  Status  word  in  octal.  PC-r^ 
is  the  octal  location  of  the  failure  in  the  lOX  code. 

User  Action:  Look  up  the  I/O  error  code  returned  to  lOX  by  PCS 
in  the  IAS/RSX-11  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 
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lOX  —  Invalifl  pattern  number 

Explanation;  You  triers  to  set  a  data  pattern  using  a  pattern 
number  greater  than  12.  The  valid  arguments  for  PATTERN  are  0 
through  12. 

User  Action:   Rnter  a  valid  pattern  number. 

TOX  —  Invalid  task  name 

Explanation:  The  task  name  that  you  specified  with  the  EXECUTE 
command  is  invalid.  The  task  name  is  either  incorrect  or  the 
task  does  not  exist. 

User  Action:  Reenter  the  task  name  correctly  or  determine  if  the 
task  exists. 

lOX  —  No  activity  remains  -  aborting 

Explanation:   In  Execution  Mode,  TOX  determines  whether   or  not 

any   exercises  are  in  progress  or  any  tasks  are  executing  at  one 

minute  intervals.  If  lOX  finds  no  activity,  it  aborts  the 
exercise  and  generates  this  info  inational  message. 

In  Interactive  MoJe,  TOX  determines  v/hether  or  not  any  exercises 
are  in  progress  or  any  tasks  are  executing  only  when  you  enter 
the  PROCEED  command.  If  there  is  no  activity  wNen  you  enter 
PROCEED,  lOX  aborts  the  exercise  and  iFsuea  this  informational 
message. 

User  Action:   None. 

TOX  —  No  activity  to  start 

Explanation:  When  you  issued  t-he  START  command,  no  devices  were 
selected  for  testing  and  no  ta^.  s  were  initiated  for  execution. 

User  Action:  Select  devices  that  you  want  to  test,  and  use  the 
EXECUTE  command  to  initiate  tasks  that  you  want  to  execute. 

lOX  —  No  buffer  space  available 

Explanation:  lOX  does  not  have  adequate  buffer  space  to 
accommodate  all  the  devices  you  selected. 

User  Action:  Either  deselect  some  devices  from  testing  or 
reinstall  or  reinvoke  lOX  with  a  greater  incr>^Ment. 

lOX  —  No  such  command  -  type  H  for  help 

Explanation:   You  entered  a  command  that  lOX  did  not  recognize. 

User  Action:  Enter  H  (abbreviation  for  the  HELP  command) ,  which 
displays  a  summary  all  lOX  commands. 
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lOX  —  No  tasks  to  ^bort 

Explanation:  You  trie<1  to  abort  tasks  using  the  ABORT  command 
when  no  tasks  hart  been  initiated  by  the  EXECUTE  command. 

User  Action:   None. 

TOX  —  Only  CTRL/C  allowed 

Explanation:  You  set  CONTROLC  YRS  to  enable  you  to  enter  lOX 
commands  while  exercises  are  in  progress.  Therefore^  lOX  only 
accepts  CTRL/C  in  Execution  Mode. 

User  Action:  Enter  CTRL/C  to  exit  Execution  Mode,  then  lOX  is  in 
Interactive  Mode  and  you  can  enter  commands. 

TOX  —  Syntax  error 

Explanation;  The  command  line  that  you  entered  contained  a 
syntax  error. 

User  Action:  If  necessary,  check  the  syntax  of  the  command  line 
that  you  entered.   See  Section  4.12  or  type  H  (for  HELP). 

lOX  --  Task  never  executed 

Explanation:  Th*^  task  that  you  tried  to  abort  is  not  on  the  list 
of  tasks  initiated  by  the  EXECUTE  command. 

User  Action:  Use  the  PARAMETERLIST  command  to  check  the  list  of 
tasks  to  be  executed. 

TOX  —  Task  "xxxxxx"  is  currently  active 

Explanation:  You  tried  to  execute  a  task  that  was  already 
active.   The  name  of  the  task  is  "xxxxxx". 

User  Action:   None. 

TOX  —  Task  "xxxxxx"  is  completed.   Status-  nnnnnnn 

Explanation:  The  task  has  completed  execution.  The  name  of  the 
task  is  "xxxxxx".  There  are  four  task  statuses  represented  by 
"nnnnnnn":   SUCCESS,  WARNING,  ERROR,  and  SEVERE  ERROR. 

User  Action:   None. 

TOX  —  Task  "xxxxxx"  is  not  installed 

Explanation;  Task  "xxxxxx"  is  not  installed  and  cannot  be 
initiated  using  the  EXECUTE  comm=)nd. 

User  Action:   Install  the  task  from  a  privileged  terminal. 
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lOX  —  Task  "xxxxxx"  is  unable  to  execute 

Explanation:   Task  "xxxxxx"  could  not  execute. 
User  Action:   Try  to  execute  the  task  again. 

TOX  —  Units  ire  selected  -  command  ignored 

Explanation:   The  BUFFERSI7E  command  is  valid  only   if   no   units 
are  selected  for  testing. 

User  Action:   You  can   use   the   BUFFERSUE   command   within  the 

SELECT  and  VERIFY  command  lines  to  override  the  default  for  each 

device.   However,  if  you  require   a   larger   BUFFERSIZE   for  all 

devices,   use   the   DESELECT  command  to  deselect  all.  units;  then 
reissue  the  BUFFERSIZE  command. 
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THE  BAD  BLOCK  REPLACEMENT  CONTROL  TASK  (RCT) 


The  Bad  Block  Replacement  Control  Task  (RCT)  h'  ndles  bad  block 
replacement  and  recovery  on  Mass  Storage  Control  Prcuocol  (MSCP)  disks 
such  as  the  RA80.  Bad  block  handling  on  MSCP  disks  consists  of  four 
stages:  detecting,  notifying,  replacing.  "- •'  revectoring.  The  disk 
controller  (UDA50)  handles  the  detecti^.  jf  bad  blocks  and 
notification  of  the  driver  (DUDRV) .  The  vec  activates  RCT.  RCT 
performs  all  the  bad  block  replacement  funccions  that  enable  the 
controller  to  revector  (redirect)  I/O  from  Lhe  bad  block  to  the 
replacement  block. 

RCT  also  performs  replacement  and  recovery  on  MSCP  disks  that  went  off 
line  during  bad  block  replacement  or  before  the  contents  of  a 
write-back  cache  was  copied  to  the  disk. 


5.1  BAD  BLOCK  REPLACEMENT  FUNCTIONS 

RCT  performs  the  following  bad  block  replacement  functions: 

•  Stores  data  from  the  bad  block 

•  Allocates  a  replacement  block 

•  Updates  data  structures  on  the  disk 

•  Initializes  the  replacement  block 

5.2  RECOVERY  TECHNIQUES 

RCT  checks  MSCP  disks  that  have  just  come  on  line  for  two  conditions: 
incomplete  bad  block  replacement,  and  write-back  cache  corruption.  If 
RCT  determines  that  bad  block  replacement  was  partially  completed  when 
tne  disk  went  off  line,  RCT  completes  the  bad  block  replacement 
process.  If  RCT  determines  that  the  write-back  cache  was  not  copied 
to  the  disk  before  the  disk  went  off  line,  RCT  software  write-locks 
the  disk  so  that  the  content  of  the  write-back  cache  is  preserved. 
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5.3   INSTALLING  RCT 

If  you  select-,  a  DU:  device  in  SYSGEN,  RCT...  and  DUDRV  are  both 
built.  RCT...  is  installed  and  DUDRV  is  loaded  in  SYSVMR.CMD.  You 
load  or  install  and  load  RCT...   and  DUDRV  only  if: 

•  You  have  removed  RCT...   and/or  unloaded  DUDRV. 

•  You  have  edited  SYSVMR.CMD  to  exclude  one  or  both. 

If  you  manually  install  RCT...  and  load  DUDRV,  you  must  install 
RCT...  first.  Otherwise,  you  receive  a  message  at  the  console 
terminal,  indicating  that  the  Replacement  Control  Task  is  not 
instal led . 

To  install  RCT,  use  the  following  command  line: 

>INS  SRCT/TASK«RCT. . . 


5.4   DISK  CONFIGURATION  OF  MSCP  DISKS 

Three  address  spaces  on  MSCP  disks  are  relevant  to  RCT: 

•  Logical  blocks  (LBNs) 

•  Replacement  blocks  (RBNs) 

•  Revector  control  tables 


5.4.1   Logical  Blocks  (LBNs) 

Logical  blocks  (LBNs)  are  accessible  to  user  tasks  for  transferring 
data  between  the  disk  and  the  operating  system.  When  the  controller 
encounters  a  bad  LBN  and  notifies  DUDRV,  DUDRV  activates  RCT  to 
replace  the  LBN. 


5.4.2   Replacement  Blocks  (RBNs) 

Replacement  blocks  (RBNs)  are  blocks  reserved  throughout  the  disk  that 
RCT  allocates  as  substitutes  for  bad  LBNs.  RBNs  cannot  be  directly 
accessed  by  user  tasks  during  normal  data  transfers. 


5.4.3   Revector  Control  Tables 

The  revector  control  tables  are  accessible  only  by  RCT  (by  way  of 
DUDRV)  and  the  device  controller.  Each  table  entry  corresponds  to  an 
RBN  according  to  its  location  ir  the  table.  An  entry  contains  the  LBN 
being  replaced  and  a  code  describing  the  status  of  the  RBN.  There  are 
five  status  codes:  ALLOCATED,  UNALLOCATED,  UNUSABLE,  PRIMARY,  and 
SECONDARY. 

For  a  given  LBN,  a  primary  RBN  is  in  a  predetermined  location,  such  as 
the  last  sector  of  the  same  track  as  the  LBN.  For  thit  LBN,  all  other 
RBNs  are  secondary. 
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Sector  0  of  the  revector  control  tables  stores  information  in  a  flag 
word  that  enables  RCT  to  determine  if  recovery  techniques  are  required 
when  a  disk  is  brought  on  line. 


5.S   BAD  BLOCK  HANDLING  ON  MSCP  DISKS 

Bad  block  handling  on  MSCP  disks  consists  of  four  stages: 

•  Detection  performed  by  the  device  controller,  UDA50 

•  Notification  performed  by  the  controller   which   notifies   the 
driver,  DUDRV 

•  Replacement  performed  by  RCT 

©   Revectoring  performed  dynamically  by  the  device  controller 


5.5.1   Bad  Block  Detection 

The  UDA50  controller  may  detect  a  bad   LBN   while   processing   an   I/O 
request  from  the  driver. 


5.5.2   Bad  Block  Notification 

When  the  UDA50  controller  detects  a  bad  LBN,  it  notifies  DUDRV  by 
listing  the  bad  LBN  in  an  end  packet.  DUDRV  stores  this  information 
in  pool  and  activates  RCT. 

DUDRV  provides  RCT  with  the  information  necessary  to  perform  bad  block 
replacement : 

•  LBN 

•  I/O  packet  address 

•  Unit  Control  Block  (UCB)  address 


5.5.3   Bad  Block  Replacement 

RCT  performs  the  following  steps  in  bad  block  replacement: 

1.  Emulates  an  ATTACH  to  the  disk,  inhibiting  all  I/O  other  than 
I/O  necessary  for  bad  block  replacement. 

2.  Reads  the  data  from  the  bad  LBN  into  a   buffer   in   its   data 
space. 

3.  Determines  which  RBN   on   the   disk   to   use   by   applying   a 
predetermined  algorithm. 

4.  Issues  QIOs  to  DUDRV  that  update  the  revector  control   tables 
(discussed  in  Section  5.4.3). 
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5.  Updates  the  header  and  data  of  the  bad  LBN  by  issuing  an 
lO.RPL  to  DUDRV.  This  I/O  function  code  directs  the 
controller  to  indicate  in  the  header  of  the  LBN  that  the  LBN 
has  been  replaced  either  by  a  primary  or  secondary  RBN  and 
writes  128  copies  of  the  address  of  the  RBN  in  the  data  field 
of  the  LBN. 

6.  Initializes  the  RBN  by  writing  the  data  read  from  the  LBN 
back  to  the  bad  LBN.  Since  the  bad  LBN  has  been  replaced  by 
the  RBN,  the  data  is  transparently  written  to  the  RBN  by  the 
control ler . 

If  an  RBN  Is  bad,  RCT  treats  it  as  a  bad  LBN.  RCT  finds 
another  RBN,  updates  the  revector  control  tables,  marks  the 
old  RBN  as  unusable,  and  initializes  the  new  RBN  by  writing 
the  stored  data  back  to  the  bad  LBN. 

7.  RCT  detaches  the  unit,  and  normal  I/O  to  the  di^k  resumes. 


5.5.4   Bad  Block  Revectoring 

Revectoring  is  performed  dynamically  by  the  device  controller.  When 
the  controller  first  accesses  an  LBN  that  has  been  replaced  by  RCT, 
the  controller  revectors  (redirects)  the  I/O  to  the  RBN  that  RCT 
designated  as  the  replacement  for  the  LBN.  Thereafter,  I/O  to  the  tad 
LBN  is  transparently  revectored  to  the  RBN  without  DUDRV's  activating 
RCT. 


5.5.4.1  Primary  RBNs  -  When  the  controller  detectr  a  bad  LBN  whose 
header  indicates  that  it  has  been  replaced  by  a  primary  RBN,  the 
controller  directly  accesses  the  RBN. 


5.5.4.2  Secondary  RBNs  -  When  the  controller  detects  a  bad  LBN  whose 
header  indicates  that  it  has  been  replaced  by  a  secondary  RBN,  the 
controller  must  look  up  the  address  of  the  RBN  before  it  can  access 
the  RBN.  The  controller  finds  the  address  of  the  secondary  RBN  in  one 
of  two  ways: 

1.  Checking  the  data  field  of  the  bad  LBN,   which   contains   the 
128  'Topies  of  the  RBN 

2.  Checking  the  revector  control  tables  for  the  entry  containing 
the  bad  LBN 


5.6   COMPLETIf   PARTIAL  BAD  BLOCK  REPLACEMENTS 

When  a  disk  unit  is  brought  on  line,  RCT  checks  that  no  bad  block 
replacement  was  in  progress  when  the  disk  went  off  line  by  checking 
the  flag  word  in  sector  0  of  the  revector  control  table.  If 
replacement  needs  to  be  completed,  RCT  completes  the  bad  block 
replacement. 
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5.7   PREVENTING  LOSS  OF  WRITE-BACK  CACHE  DATA 

RCT  prevents  loss  of  write-back  cache  data. 

A  disk  with  the  wr i te-back-cache-in-use  flag  set  will  be  write-locked 
each  time  it  is  brought  on  line.  To  write-enable  such  a  disk,  use  the 
/WRITE  qualifier  with  the  MCR  MOUNT  command  each  time  you  mount  the 
disk.  RCT  checks  the  wr ite-back-cache-in-use  flag  word  in  sector  0  of 
the  revector  control  tables,  software  write-locks  the  disk  if  the  flag 
is  set,  and  writes  the  following  TKTN  message  to  the  console  output 
device  (CO: ) : 

ddnn:  —  Write  back  caching  data  lost.   Unit  write  locked 

where  ddnn:   is  the  disk  that  RCT  has  write  locked. 


NOTE 

Because  RSX-llM  and  RSX-llM-PLUS 
operating  systems  do  not  support  disks 
with  write-back  caching,  this  function 
is  extremely  rare. 

RCT  performs  this  function  only  under  the  following  circumstances: 

1.  A  disk  with  a  write-back  cache  failed  to  copy  the  data  from 
the  write-back  cache  to  the  disk  before  going  off  line,  while 
on  another  operating  system  (that  supports  write-back 
caching) ,  and  was  then  moved  to  an  RSX-llM  or  RSX-llM-PLUS 
operating  system. 

2.  The  revector  control  tables  have  been  altered  such  that  the 
write-back-cache-' n-use  flag  is  set. 


5.fl   RCT  AND  OTHER  RSXllM/M-PLUS  UTILITIES 

Utilities  such  as  BAD,  BRU,  and  INI  treat  MSCP  devices  as 
non-last-track  devices.  RCT  does  net  replace  the  BAD  utility.  You 
must  run  BAD  on  MSCP  devices  to  create  a  bad  block  descriptor  file 
before  you  initialize  the  disk.  You  can  use  BAD  to  find  bad  blocks 
and  list  tnem  in  a  bad  block  descriptor  file.  However,  the  bad  block 
descriptor  file  will  not  contain  any  information  about  blocks  detected 
by  the  device  controller  and  replaced  by  RCT. 


5.9   RCT  AND  THE  ERROR  LOGGER 

DUDRV  notifies  the  Error  Logger  with  an  error  log  packet  whenever  an 
error  has  been  detected  that  requires  bad  block  replacement.  RCT  also 
generates  an  error  log  packet  indicating  that  a  bad  LBN  has  been 
successfully  (or  unsuccessfully)  replaced  by  an  RBN.  RCT  logs  the 
packet  under  the  name  of  the  task  that  issued  the  QIO  resulting  in  the 
detection  of  the  bad  block  by  the  controller. 
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RBSOORCE  MONITORING  DISPLAY  (RMD) 


The  Resource  Monitoring  Display  (RMD)  is  a  privileged  task  that 
displays  information  about  the  resources  in  your  system.  This 
information  includes  the  active  tasks,  their  location  in  memory,  the 
amount  of  memory  they  occupy,  and  available  pool  space.  On  video 
terminals  such  as  VT52s  and  VTlOOs,  RMD  provides  dynamic  displays.  On 
hardcopy  terminals  such  as  LAlSOs,  RMD  provides  "snapshot"  displays. 
RMD  alters  the  display  format  according  to  terminal  type  without  your 
having  to  set  switches  or  rebuild  the  task. 


6.1   IHTRODOCTION 

RMD  consists  of  "pages".  A  page  consists  of  24  lines,  which,  on  CRT 
terminals,  is  one  screen.  The  program  contains  two  kinds  of  pages: 
display  pages  and  setup  pages. 


6.1.1  Display  Pages 

There  are   four   display  pages   available  on   both   RSX-llM   and 
RSX-IIM-PLUS  systems: 

•  Memory  (M) 

•  Active  Task  List  (A) 

•  Task  Header  (T) 

•  Help  (H) 

Th«r*  iktm  two  additional  display  pages     that     ar*     availabl*     only     on 
KSX-llM-PLOS  systaas: 

•  I/O  Counts  (I) 

•  Systea  Statistics  (S) 

You  press  tae  terminal  keys  indicated  in  parentheses  to  switch  display 
pages. 


6.1.2  Satap  Pages 

There  are  three  setup  pages.  Each  setup  page  is  associated  with  a 
display  page.  (The  Help  Display  Page  has  no  associated  setup  page.) 
You  access  a  setup  page  from  a  display  page  by  pressing  the  ESCAPE  key 
on  your  terminal.  The  setup  page  documents  and  prompts  you  for  setup 
commands,  which  alter  the  content  of  the  information  displayed  on  the 
associated  display  page. 
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6.2   INSTALLING  AND  INVOKING  RMD 

Individual  users  can  invoke  RMD  at  their  terminals.  For  large  systems 
that  support  many  terminals,  you  may  want  to  run  RMD  continuously  on  a 
slaved  terminal  near  the  computer.  You  use  different  procedures  to 
install  and  invoke  RMD  for  use  by  individual  users  and  to  run  RMD  on  a 
slaved  terminal. 


6.2.1  Osing  RMD  at  Individual  Terainals 

On  RSX-llM  systana,  RMD  la  inatallad  if  you  aalactad  RMD  at  ayatMB 
generation. 

On   R8X-lJJNL^WlJB#  JRBS  i».inSJMlUS!4n 


6.2.1.1  Inatalling  RMD  for  Oaa  at  Individual  Taminala  -  You  must 
install  RMD  if  you  have  removed  it.  To  install  RMD,  use  the  MCR 
INSTALL  command  at  a  privileged  terminal: 

>INS  $RMD 


6.2.1.2   Invoking   RMD   for   Use  at   Individual   Terainals  -  From  any 
terminal,  you  invoke  an  installed  copy  of  RMD  from  MCR  as  follows: 


>RMD  [page] [ ,setupcommand ] 


page 


One  of  the  display  page  abbreviations  (M,  A,  T,  or  H) .  The 
default  page  is  the  Memory  Display  (M) . 

setupcoaatand 

A  valid  setup  command  for  the  display  page  that  you  have 
selected.  The  setup  commands  are  the  same  as  those  available  to 
you  from  the  setup  page  associated  with  the  display  page  you 
specified.  The  default  setup  conunands  are  discussed  in  Sections 
6.4  through  6.6,  which  describe  the  content  of  each  display  page 
and  how  you  use  setup  commands  to  alter  display  parameters. 

From  a  privileged  terminal  only,  you  can  invoke  an  uninstalled  copy  of 
RMD  using  the  MCR  RUN  command.  However,  MCR  command  line  parsing  is 
available  only  if  RMD  is  installed. 


6.2.2  Running  RMD  on  a  Slaved  Terminal 

To  run  RMD  on  a  slaved  terminal  and  also  allow  users  to  invoke  RMD  at 
their  own  terminals,  RMD  must  be  installed  twice  using  different  task 
image  files  and  different  task  names. 

On  RSX-llH  aystaaa,  if  you  aalactad  RHD  at  ayaten  generation,  you  will 
find  RMD.TSK,  which  has  b««n  task  built  at  aystaa  generation  with  task 
nan*  ...RMD*  in  8TSUIC  on  your  systm  disk. 
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On  R8X-11M-PLUS  systems,  you  will  find  RMD.TSK,  which  has  been  task 
built  at  system  generation  with  task  name  ...RMD,  in  SYSUIC  on  your 
system  disk. 

RMD.TSK  is  the  copy  of  RMD  that  the  system  installs  for  individual 
users  to  invoke.  LUNs  1  and  2  in  this  task  image  have  been  assigned 
to  TI:   so  that  a  user  at  any  terminal  can  invoke  RMD. 

To  run  RMD  on  a  slaved  terminal,  do  the  following: 

1.  From  a  privileged  terminal,  make  a  copy  of  RMD.TSK  in  SYSUIC 
on  your  system  disk  named  RMDEMO.TSK.  If  your  SYSUIC  is 
[1,54]  and  your  system  disk  is  DRO:,  use  the  following 
command  sequence: 

>SET  /UIC-[1,541 

>ASN  DRO:=SY: 

>PIP  RMDEMO.TSK-RMD.TSK 

2.  Either  from  a  privileged  terminal  or  from  a  command  file  to 
be  executed  at  a  privileged  terminal,  install  RMDEMO  using 
the  following  command  sequence: 

>INS  RMDEMO/TASK-RMDEMO 

>REA  RMDEMO  1  ttnn: 

>REA  RMDEMO  2  ttnn: 

>SET  /SLAVE=ttnn: 

>RUN  RMDEMO 

where  ttnn:   is  the  terminal  at  which  you  want  to  run  RMD. 

This  command  sequence  installs  RMD  with  task  name  RMDEMO, 
reassigns  LUNs  1  and  2  to  the  terminal  you  want  to  slave  to 
the  task,  slaves  the  terminal,  and  invokes  the  task. 

Because  the  REASSIGN  command  alters  the  task  image  on  disk, 
you  must  use  two  task  images  rather  than  simply  installing 
RMD  twice  with  different  task  names. 


6.3   THE  HELP  DISPLAY 

The  Help  Display  documents  how  you  switch  display  pages.  You  switch 
display  pages  by  pressing  a  terminal  key  as  follows: 

Key  Explanation 

N  Accesses  the  Memory  Display 

h  Accesses  the  Active  Task  Display 

t  Accesses  the  Task  Header  Display 

I  Accesses  the  I/O  Counts  Display 

•  Accesses  the  System  Statistics  Display 

The  Help  Display  also  documents  how  to  exit  from  RMD  to  MCR  and  use 
the  ESCAPE  key  to  access  setup  pages  from  their  associated  display 
pages.  (Because  there  is  nothing  to  alter  on  the  Help  Display,  no 
setup  page  is  available  from  the  Help  Display.) 

Thfe  Memory,  nctive  Task,  and  Task  Header  Displays  use  the  entire 
screen.  Therefore,  you  receive  no  prompts  or  documentation  on  display 
oages.  To  find  out  how  to  access  a  setup  page  from  a  display  page  or 
how  to  switch  display  pages,  press  the  H  key  (for  Help)  to  access  the 
Help  Display. 
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6.4   THE  MEMORY  DISPLAY 

The  Memory  Display  graphically  represents  the  entire  system  memory, 
including  the  approximate  size  and  locations  of  partitions  and  active 
tasks.  The  display  also  shows  pool  statistics,  the  name  of  the  task 
that  is  currently  executing,  and  other  information  about  the  status  of 
your  operating  system.  You  access  the  Memory  Display  from  another 
display  page  by  pressing  the  M  key  (for  Memory).  To  access  the  Memory 
Display  from  the  MCR  command  line,  you  type: 

>RMD  M 


If  you  invoke  RMD  without  specifying  a  display  page: 

>RMD 

RMD  defaults  to  the  Memory  Display. 

Figures  6-1  and  6-2  show  "snapshots"  of  the  Memory  Display  for  RSX-llM 
and  RSX-llM-PLUS  respectively.  The  reverse  numbers  in  each  figure 
(white  numbers  in  black  circles)  match  the  reverse  numbers  in  the 
explanations  that  follow  the  two  figures,  where  a  display  field  is 
the  same  for  both  RSX-llM  and  RSX-llM-PLUS,  it  is  designated  by  the 
same  reverse  number  in  Figures  6-1  and  6-2.  The  matching  explanation, 
however,  appears  only  once. 
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Figure  6-1      RSX-llM  Memory  Display 
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■2     RSX-llM-PLUS  Memory  Display 


O   Operating  system  type,  version  number,  and  base  level. 

O  Six-character  name  that  is  a  DECnet  node  name  (if  DECnet  is 
running  on  your  system)  or  the  system  name  that  you  selected  in 
SYSGEN  (if  DECnet  is  not  running  on  your  system). 

Q   Size  in  K  words  of  the  system  memory. 

O  For  RSX-llM-PLUS  systems,  time  elapsed  in  units  of  days,  hours, 
and  minutes,  since  the  system  was  last  booted. 

0   Current  date  and  time. 

O  Name  of  the  task  that  is  currently  executing  or,  if  none  is 
executing,  *IDLE*  (Executive  executing  the  idle  loop). 

0  Number  of  free  blocks  on  the  first  four  Files-11  devices  in  your 
system.  If  a  device  is  dismounted,  RMD  displays:  "DM0".  If  a 
device  is  off  line,  RMD  displays:   "OFL" . 
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RB800RCI  HONITORIMG  DISPLAY  (RHO) 

Pool  (dynamic  8tocag«  region)  infornation  in  the  focnat: 

POOL"X:Y:Z 

X 

Number  of  words  in  thn  largest  free  block  in  pool 
¥ 

Mufflber  of  free  words  in  pool 
I 

Number  of  fragments  in  the  pool  free  list 

The  second  line  records  the  worst  case  of  pool  since  you  invoked 
RMD.  This  line  is  most  useful  if  RND  has  been  running  on  a 
slaved  terminal  since  the  system  was  last  booted. 


On  R8X-11H-PL08  systMM,  ••condary  pool   infforwition  ia  th« 
f oraat : 

8BCP00L-A:B:C% 


MiMiber  of   £r*«  blocks   in  ••condary  pool 


C% 


Total  nuabor  of  blocks  in  secondary  pool 


Porcantaga  of  sacojidary  pool  that  is  fr*e 


The  sacond  lina  records  tha  worst  caaa  of  secondary  pool  since 
you  invoked  RNO.  Thia  line  is  amst  useful  if  RM)  haa  been 
running  on  a  alavad  terminal  since  the  systesi  was  laat  booted. 

®   Partitions  in  the  system  using  the  format: 

part itionname: type 

type 

For  R8X-11H  systesis  (Figure  6-1),  one  of  the  followingt 

T  Task  partition 

8  Subpartition 

D  Syataa-controllad  (dynamic)  partition 

C  Common  partition 

For  R8X-11N-PL08  systems  (Figure  6-2),  ona  of  the  following: 

D  System-controlled  (dynamic)  partition 
P  Secondary  pool  partition 

Q  Number  of  tasks  in  memory  and  amount  of  memory  they  use,  and 
number  of  active  tasks  swapped  or  checkpointed  out  of  memory  and 
the  amount  of  memory  they  would  require. 


• 
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RESOUHCE  MONITORING  DISPLAY  (RMD) 

Name  of  each  task,  common,  or  driver  In  memory  and  Its  location 
in  memory  using  the  following  symbols  to  designate  size,  type 
(task,  common,  or  driver),  and  other  attributes: 

Symbol  Attribute 

Active  task 

Task  not  active,  yet  occupies  memory 

Named  common 

Unnamed  common  (displayed  name  is  first   attached 

task) 
Loaded  driver  using  device  mnemonic 
Task  not  fixed  in  memory 
s33>s       Task  fixed  in  memory 

The  hyphens  and  equal  signs  represent  the  amount  of  memory  that 
each  task,  driver,  or  common  occupies.  Where  the  display  shows 
only  one  delimiter  and  no  hyphens  or  equal  signs,  the  open 
delimiter  Is  in  the  same  location  as  the  closing  delimiter  of  the 
preceding  task, 

0  Partition  size  and  location.  The  beginning  of  each  partition  is 
marked  with  the  same  symbols  as  those  listed  previously  plus  the 
following  additions  for  both  operating  systems: 

E   Executive 
P   Pool 

The  lines  of  asterisks  are  proportional  representations  of  the 
amount  of  memory  occupiea  by  each  partition.  The  numbers  are  in 
IK  word  increments.  Each  numerical  character  also  represents  the 
same  amount  of  memory  ^3  an  asterisk.  RHD  always  divides  the 
system  memory  into  groups  of  eight  units. 

^  System  error  count  sequence  recorded  by  the  Error  Logger  (always 
zero  if  Error  Logger  not  present  in  yo-jr  syste  i)  . 


<>.4.1   Altering  the  Memory  Display  from  the  Setup  Page 

To  alter  the  Memory  Display,  you  press  the  ESCAPE  key,  which  accesses 
the  setup  page  for  the  Memory  Display.  The  setup  page  documents  and 
prompts  you  for  commands  which  you  use  to  alter  the  Memory  Display. 
You  can  enter  multiple  commands  after  each  prompt  by  using  commas  as 
separators.  The  setup  commands  available  for  altering  the  Memory 
Display  are: 

•  FREEx'ddnn:   where  x  is  a  number  from  0  to  3  and  ddnn:    is   a 
device  name  and  number 

•  RATERS  where  s  Is  the  replot  rate  in  seconds 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  stay  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  back  to  the  Memory  Display. 
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RESOURCE  MONITORING  DISPLAY  (RMD) 

'>.4.1.1  The  FREE  Cominand  -  You  use  this  command  to  determine  the  four 
Files-11  devices  for  which  you  want  the  Memory  Display  to  show  the 
available  free  blocks.  This  information  is  (7)  in  both  Figures  fi-1 
and  6-2.  The  default  is  yoi- •  system  disk  (SY:)  and  the  next  three 
Files-11  devices  in  your  configuration. 


6.4.1.2  The  RATE  Command  -  You  use  this  command  to  determine  how 
often  RMD  replots  the  Memory  Display  if  you  are  running  RMD  on  a  CRT. 
The  default  replot  rate  in  once  per  second. 


6.4.2  Altering  the  Memory  Display  from  the  MCR  Command  Lin* 

You  can  enter  the  FREE  and  RATE  commands  as  part  of  the  MCR  command 
line.  (The  general  format  of  the  MCR  command  line  is  discussed  in 
Section  6.2.1.2.)  For  example,  when  you  enter  the  MCR  command  line 

>RMD  M,FREE3=DM0: ,RATE»3 

RMD  displays  the  number  of  free  blocks  on  DM0:  instead  of  the  fourth 
Files-11  device  in  your  configuration  and  replots  the  display  every 
three  seconds  instead  of  every  second. 

To  change  the  second  and  third  Files-11  devices  to  DBl:  and  DB2: 
respectively,  use  the  MCR  command  line: 

>RMD  M,FF,EE1=DB1:  ,FREE2=DB2: 

These  setup  parameters  stay  in  effect  until  you  alter  them  by  using 
setup  commands  fron  the  setup  page.  Even  if  you  switch  to  another 
display  page  and  back  to  the  Memory  Display,  RMD  does  not  restore  the 
default  setup  parameters. 


6.5   THE  ACTIVE  TASK  DISPLAY 

The  Active  Task  Display  shows  you  the  active  tasks  in  the  system.  You 
access  this  display  from  another  display  page  by  pressing  the  A  key 
(for  Active  Task).  To  access  this  display  from  the  MCR  command  line, 
you  type: 

>RMD  A 

This  display  has  six  fields: 

•  Name  of  the  task 

•  Length  of  the  task  in  octal  bytes 

•  Terminal  that  issued  the  task 

•  Running  priority  of  the  task 

•  Outstanding  I/O  count 

•  Status  flags 

The  status  flags  use  the  same  mnemonics  as  the  MCR  ATL  command.  See 
the  RSX-llM/M-PLUS  MCR  Operations  Manual  for  the  definitions  of  the 
status  flags. 
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RI800ICI  NOHITOSIMG  DISPLAY  (BMD) 

6.5.1  Altering  th*  Activ*  Task  Display  froa  tha  Satup  Paqa 

To  alter  the  Active  Task  Display,  you  press  the  ESCAPE  key,  which 
displays  the  setup  page  for  the  Active  Task  Display.  The  setup  page 
documents  and  prompts  you  for  commands  that  you  use  to  alter  the 
Active  Task  Display.  You  can  enter  multiple  commands  after  each 
prompt  by  using  commas  as  separators.  The  setup  commands  available 
for  altering  the  Active  Task  Display  are: 

•  OWNER-ttnn:   where  ttnn:   is  the  terminal  that  issued  the  task 

a  PRIORITY-p  where  p  is  a  task's  running  priority 

a  RATE'S  where  s  is  the  replot  rate  in  seconds 

a  TASK-taskname  where  taskname  is  the  name   of   the  task  whose 
header  you  want  to  display 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  stay  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  back  to  the  Active  Task  Display. 


6.5.1.1  The  OWMBR  Coaaand  -  This  command  allows  RMD  to  display  only 
those  tasks  that  have  been  issued  by  a  particular  terminal.  The 
default  is  ALL,  which  displays  tasks  issued  from  all  terminals. 


6.5.1.2  The  PRIORITY  Coaaand  -  The  active  task  list  may  be  too  long 
to  fit  on  one  screen.  You  use  the  PRIORITY  command  to  determine  the 
highest  priority  tasks  that  you  want  to  see.  The  default  is  250,  the 
highest  possible  priority. 


6.5.1.3  The  RATE  Coaaand  -  This  command  allows  you  to  determine  how 
often  RMD  replots  the  Active  Task  Display,  if  you  are  running  RMD  on  a 
CRT.   The  default  replot  rate  is  once  per  second. 


6.5.1.4  The  TASK  Coaaand  -  This  command  allows  you  to  look  at  a 
specific  task  header.  This  command  is  an  exception  because  it  is  the 
only  setup  command  that  switches  display  pages.  There  is  no  default 
for  the  TASK  command.  The  Task  Header  Display  is  discussed  in  Section 
6.6. 


6.5.2  Altering  the  Active  Task  Display  from  the  MCR  Coaaand  Line 

You  can  enter  the  same  setup  commands  discussed  in  the  previous 
section  as  part  of  the  MCR  command  line.  For  example,  when  you  enter 
the  MCR  command  line: 

>RMD  A, PRIORITY=200,RATE=3 

RMD  displays  the  Active  Task  Display  using  200  as  the  maximum  task 
priority  and  replots  the  display  every  three  seconds. 

To  display  only  those  tasks  issued  by  your  terminal,  type: 
>RMD  A,OWNER=TI: 
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IBSOORCS  MOaiTOIIMG  DISPLAY  (RMD) 

6.6   THB  TASK  HBADIR  DISPLAY 

The  Task  Header  Display  shows  you  the  task  header  of  the  task  you 
specify.  You  access  this  display  from  another  display  page  by 
pressing  the  T  key  (for  Task  Header).  If  no  task  is  currently 
specified,  RMD  shows  you  the  setup  page  first  so  that  you  can  specify 
the  task  whose  task  header  you  want  RMD  to  display. 

To  access  the  Task  Header  Display  from  the  NCR  command  line,  you  type: 

>RMD  T,TASK«taskname 

where  taskname  is  the  name  of  the  task  whose  header  you  want  RMD  to 
display. 

If  you  invoke  RMD  from  the  MCR  command  line  without  specifying  the 
name  of  a  task: 

>RMD  T 

RMD  displays  the  setup  page  first  so  that  you  can  specify  the  name  of 
the  task  whose  header  you  want  RMD  to  display. 

The  Task  Header  Display  shows  you  the  following  information  about  the 
specified  task: 

e  Name  of  the  task 

e  Name  of  the  partition  in  which  the  task  runs 

e  Status  flags,  which  have  the  same  mnemonics  as  in   the   Active 
Task  display 

•  Owner  of  the  task  by  terminal  number 
e  Outstanding  I/O  count 

e  Default  priority 

e  Running  priority 

•  Swapping  priority 

•  Length  in  decimal  words 

e  Contents  of  the  six  general   purpose   registers,   the  program 
counter,  and  the  Processor  Status  Word 

e  Contents  of  the  Directive  Status  Word  ($DSW) 

e  Local  event  flags 

e   Logical  unit  number  (LUN)  assignments  to  a  maximum  of  26  LUNs 

When  RMD  displays  file  names  in  the  list  of  LUN  assignments,  the 
filename  and  UIC  displayed  are  the  filename  and  UIC  of  the  file  when 
it  was  created.  If  the  file  has  been  renamed,  the  RMD  display  may  not 
reflect  the  current  UIC  and/or  filename. 
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RISOORCI  NOMITORIHG  DISPLAY  (RHD) 

6.6.1  Altering  th«  Task  H«ad«r  Display  froa  ths  Satup  Paga 

To  altar  the  Task  Header  Display,  you  press  the  ESCAPE  Icey,  which 
displays  the  setup  page  for  the  Task  Header  Display.  The  setup  page 
documents  and  prompts  you  for  commands  that  alter  the  Task  Header 
Display.  You  can  enter  multiple  commands  after  each  prompt  by  using 
commas  as  separators.  The  setup  commands  available  for  altering  the 
Task  Header  Display  are: 

a   RATE'S  where  s  's  the  replot  rate  in  seconds 

a  TASK>taskname  where  taskname  is  the  name  of   the  task  whose 
header  you  want  to  display 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  remain  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  back  to  the  Task  Header  Display. 


6.6.1.1  The  RATE  Cosaaand  -  This  command  allows  you  to  determine  how 
often  RMD  replots  the  Task  Header  Display  if  you  are  running  RMD  on  a 
CRT.   The  default  replot  rate  is  once  per  second. 


6.6.1.2  The  TASK  CoHiand  -  This  command  changes  the  task  header  to  be 
displayed.  There  is  no  default.  The  TASK  command  has  the  same 
function  as  the  TASK  command  on  the  Active  Task  Display,  except  that 
here  it  does  not  switch  display  pages. 


6.6.2  Altering  the  Task  Header  Display  from  the  MCR  Conmand  Line 

Both  the  RATE  and  TASK  commands  are  available  to  you  from  the  MCR 
command  line.   If  you  invoke  RMD  using  the  following  command  line: 

>RMD  T,RATE=2,TASK=. . .EDT 

RMD  displays  the  Task  Header  Display  for  EDT,  replotting  the  page 
every  two  seconds.  You  must  give  the  full  task  name.  In  this  case 
the  taskname  is  "...EDT",  not  "EDT". 

If  you  do  not  specify  a  task  name  in  the  MCR  command  line: 

>RMD  T,RATE«2 

RMD  first  displays  the  setup  page  so  that  you  can  select  a  task  whose 
header  you  want  RMD  to  display.  The  replot  rate  will  be  set  to  two 
seconds. 


6.7  DISPLAYS  AVAILABLI  ONLY  OH  KSX-11M-PL08 

Two  displays  are  available  only  on  RSX-llN-PLOS  systens:  the  I/O 
Counts  Display  and  the  System  Statistics  Display.  These  displays  »xm 
invoked  by  the  coouBands  RMD  I  and  RMS  S,  respectively. 
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RBSOOKCB  HORITORIIG  DISPLAY  (HMD) 

6.7.1  Th«  I/O  Cenota  Display 

Tha  I/O  Counts  display  shows  you  I/O  and  arror  logging  counta  for  up 
to  aix  arror  logging  davicaa.  By  dafault,  tha  firat  six  arror  logging 
davicas  in  your  harduara  configuration  ar«>  diaplayad.  You  accaaa  thia 
diaplay  from  anothar  diaplay  by  praaaing  tha  I  kay  (for  I/O) .  To 
accass  this  display  from  tha  MCR  command  lina,  you  typa: 

>  RMD  I 

Tha  T/0  Counts  Display  has  ten  fields  for  aach  davica: 

a  Davica  name  of  the  displayed  davica 

a  Total  number  of  I/O  raquaats  to  tha  device 

e  Number  of  I/O  requests  issued  to  the  device  in  tha  laat  aacond 

a  Average  number  of  I/O  requeata  issued  to  the  device  per  second 

e  Average  number  of  cylinders  crossed  per  I/O  request  during  the 
last  second 

e  Average  number  of  cylinders  crossed  per  I/O  request 

e  Number  of  words  transferred  during  the  last  second 

a  Average  number  of  words  transferred  per  second 

e  Count  and  limit  of  soft  I/O  errors 

a  Count  and  limit  of  hard  I/O  errors 


6.7.1.1  Altering  the  I/O  Counts  Display  from  tha  Satup  Page  -  To 

alter  the  I/O  Counts  Display,  you  press  the  ESCAPE  key,  which  displays 
the  setup  page  for  the  I/O  Ccunts  Display.  The  setup  page  lists  the 
available  commands  you  can  use  to  alter  the  I/O  Counts  Display,  and 
prompts  you  for  a  command.  You  can  enter  multiple  commands  after  each 
prompt  by  using  commas  as  separators.  The  setup  commands  available 
fox  altering  the  I/O  Counts  Display  are: 

a  DEVICEx»ddnn:  where  x  is  a  number  from  0  to  6  and  ddnn:   is 
an  error  logging  device 

a  RATERS  where  s  is  the  replot  rate  in  seconds 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  Tuese 
setup  parameters  ~tay  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  then  return  to  the  I/O  Counts 
Display. 


6.7.1.1.1  The  DEVICE  Comaand  -  This  command  allows  you  to  select 
which  error  logging  devices  are  to  be  displayed.  The  device  specified 
must  be  an  error  logging  device.  If  ycu  do  not  U3e  the  DEVICE  command 
to  <«'~ecify  a  device  or  devices,  the  first  six  error  logging  devicss  in 
your  hardware  configuration  are  displayed  by  default.  See  the 
RSX-11M/M-?LUS  Error  Logging  Manual  for  a  list  of  the  error  logging 
devices. 
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BSSOOeCt  KOSITORIHG  DISPLAY  (RMD) 


6  f  .7.1.1.2  llM  lATI  Cii—iBil  -  This  cosBMnd  alloiM  you  to  dotorain*  how 
'  often  MID  copieta  th«  I/O  count*  Display,  if  you  aro  running  RHD  on  a 
vid^o  display  tarainal.  Tha  dafault  capiat  rata  ia  onca  par  sacond. 


•.7.1.2  Mt«Tlaf  tiM  I/O  Ooaata  Display  fraa  tba  NCt  Cosiund  Lina  - 
Tea  oaa  aatar  tha  OIVICI  and  HAT!  coaaands  aa  part  of  tha  NCR  coaaand 
liae.  tor  oaaaipla,  trtian  you  antar  tha  following  cosBMod  lina,  RMD 
dlsplaya  I/O  count  inforaation  for  DB3:  and  raplota  tha  diaplay  avary 
two  seconds t 

^      >  RND  I,DtVICB2»DK3:,KATI-2 

Hie  inforaation  for  DKSt  ia  displayed  in  the  position  that  would 
noraally  display  ioforsMtion  for  the  third  error  logging  device  in 
your  hardware  configuration. 

To  change  the  ficat  and  aecond  device  display  positions  to  OBI:  and 
DD2t«  respectively,  uae  the  following  NCI  coaaand  line: 

>  MO  I,  DIVICB0-I>BI:,DBVICI1-DB2: 

lliese  setup  paraaMtera  atay  in  effect  until  you  alter  thea  by  uaing 
aetup  coaaanda  froa  the  aetup  page.  Even  if  you  awitch  to  another 
display  page,  and  then  return  to  the  I/O  Counta  Diaplay,  MO)  doea  not 
restore  the  default  paraaetera. 


,  <.7.2  Hm  aystea  •tatlsties  Display 

The  tystea  Statistics  Display  ahowa  you  general  inforaation  about  tha 
operation  of  your  ayataa.  Nuch  of  thia  inforaation  coaea  froa 
MX-11H-PL08  Daaource  Accounting,  ao  thia  diaplay  ia  only  uaeful  if 
Resource  Accounting  was  included  when  your  systea  waa  generated.  Tou 
access  this  by  pressing  the  8  key.  To  access  this  display  froa  tha 
NCR  coaaand  line,  you  type: 

>  RHD  8 

The  display  haa  25  fielda. 

a  Total  nuaber  of  taaka  run 

a  Huabar  of  currently  active  tasks 

e  Total  nuaber  of  uaar  logons 

e  Wmbmt   of  users  currently  logged  oa 

e  Total  nuaber  of  runa  of  the  ahuffler 

e  8rror  aeqaence  count 

Pool  inforaation  (in  tha  aaae  foraat  aa  in  the  Naaory  Diaplay) 

foraat  as   in   tha 


a 
e 


Secondary  pool  inforaation  (in  th«>  ai 
»ry  Display) 


Percentage  of  ayataa  aaaory  uaad 
Percentage  of  ayataa  checkpoint  filea  uaad 
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Total  niHiib«r  of  dir«ctlv««  iaauad 

MoMbar  of  diractivaa  iaauad  during  tha  laat  aacond 

Avataga  nuabar  of  diractivaa  iaauad  par  aacond 

Total  nuatbar  of  QlOa  iaauad 

NuBbar  of  QlOa  iaauad  during  tha  laat  aacond 

Avaraga  nuaibar  of  QlOa  iaauad  par  aacond 

Total  nuabar  of  running  CPO  ticka 

Nuabar  of  running  CPU  ticka  during  tha  laat  aacond 

Avaraga  nuabac  of  ruwning  CPO  ticka  par  aacond 

Total  nuabar  of  taro  CPU  intarvala 

Nuabar  of  saro  CPO  intarvala  durinq  tha  laat  aacond 

Avaraga  nuabar  of  saro  CPU  intarvala  par  aacond 

Total  nuabar  of  taak  chackpointa 

Nuabar  of  taak  chackpointa  during  t.ia  laat  aacond 

AV'arage  nuabar  of  taak  chackpointa  par  aacond 


6.7.2.1  Altaring  tha  llyataa  Statiatica  Diaplay  froa  tha  Satup  Ps§«  - 
Tou  can  altar  tha  raplot  rate  on  the  Syaten  Statiatica  Diaplay  by 
praaaing  tha  ESCAPE  kay,  which  diaplaya  the  setup  page  for  tho  Syataa 
Statiatica  Diaplay.  Tha  aatup  page  lista  tha  coaaand  foraat  for 
altaring  tha  raplot  rata,  and  proapta  you  for  a  coaaand.  The  coaaand 
for  altaring  tha  raplot  rate  of  the  Syataa  Statiatica  Diaplay  ia: 

ilATE«a  where  a  ia  the  replot  rate  in  aaconda 

Tou  can  truncate  this  coaaand  to  the  single  letter  R.  Thia  aatup 
paraaater  ataya  in  effect  until  you  alter  it,  even  if  you  awitch  to 
another  diaplay  page  and  than  return  to  the  Syatem  Statintica  Diaplay. 

Tha  default  replot  rate  ia  once  per  second. 


S.7.2.2  Altocing  tha  Syataa  Statiatica  Diaplay  froa  tha  NCE  Coaaand 
Lino  -  Tou  can  enter  the  RATE  conmand  aa  part  of  tha  NCR 
coaaand  line,  for  exaapla,  when  you  enter  the  following  NCR  coaaand 
line,  RND  raplota  the  Syaten  Statistics  Display  once  every  two 
aaconda : 

>  RND  S,RATE«2 

Thia  aetup  parameter  stays  in  effect  until  you  alter  it  by  uaing  tha 
RATEan  coaaand  froa  the  aetup  page.  Even  if  you  switch  to  another 
diaplay  page  and  than  return  to  the  System  Statistics  Display,  RND 
doaa  not  raatore  tha  default  replot  rate. 
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6.8   NOOIPTIMG  THE  TASE-BDIU)  COHNAHD  FILI 

Tou  can  modify  the  task-build  comnand  file  to  change  th«  defaults   for 
RMD. 

On  R8X-I1N  systMsa,  this  fil*  Is  LBt  (1, 241MDBLD.CMD  for  aappod 
systssM  and  LB:  (l,20]mOBLO.CND  for  uruui»p«d  syst« 


On  RSK-llM-rLOB  systsua,  this  fllo  la  LBt CI, 241 KHDBLD.CMD. 
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6.9   ERROR  MESSAGES 

RMD  generates  the  following  error  messages: 

RMD  -  Allocated  screen  buffer  too  small  for  this  device 

Explanation;  RMD  requires  more  internal  memory  to  display  tne 
requested  display  on  the  type  of  terminal  on  which  you  are 
running  RMD. 

User  Action:  Rebuild  RMD  with  a  larger  screen  buffer  by 
modifying  the  task-build  command  file  as  discussed  in  Section 
fi.8. 

RMD  -  Illegal  command  -  xxxxx 

Explanation:  You  entered  an  illegal  command  xxxxx  either  on  the 
MCR  command  line  or  in  response  to  the  COMMAND>  prompt  on  a  setup 
page. 

User  Action:  Enter  the  correct  command  as  documented  in  this 
chapter. 

RMD  -  Page  does  not  exist 

Explanation:  You  requested  a  display  page  from  the  MCR  command 
line  that  does  not  exist. 

User  Action:  Enter  the  command  line  again  specifying  a  correct 
display  mnemonic. 

RMD  -  Segment  'xxxxxx'  not  found 

Explanation:  The  module  xxxxxx  was  not  found  in  the  task  image 
for  RMD.   This  denotes  an  error  in  how  RMD  was  task-built. 

User  Action:  Check  that  RMD  has  been  built  with  all  the  required 
modules. 

RMD  -  Terminal  type  not  defined 

Explanation:  The  operating  system  and  RMD  do  not  recognize  your 
terminal  type. 

User  Action:  Check  your  terminal  type  using  the  MCR  command 
SET  /TERM-TIr.  If  this  setting  is  Incorrect,  use  the  MCR  SET 
command  to  correct  your  terminal  type  setting.  If  the  setting  is 
correct,  move  to  a  different  type  of  terminal. 
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RMD  -  Terminal  type  not  set 

Explanation:  You  did  not  build  RMD  to  display  the  requested 
display  page  on  the  type  of  terminal  to  which  your  terminal  1? 
set. 

User  Action:  Determine  your  terminal  type  setting  using  the 
MCR  SET  /TERM-TI:  command.  If  this  setting  Is  Incorrect,  use 
the  MCR  SET  command  to  correct  your  terminal  type  setting.  If 
the  setting  Is  correct,  move  to  a  different  type  of  terminal. 

RMD  -  Terminal  type  not  yet  supi>orted 

Explanation:   RMD  does  not  recognize  your  terminal  type. 

User  Action:  Determine  your  terminal  type  setting  using  the 
MCR  SET  /TFRM-TI:  command.  If  this  setting  is  Incorrect,  use 
the  MCR  SET  command  to  correct  your  terminal  type  setting.  If 
the  terminal  type  is  correct,  you  can  write  a  terminal 
characteristics  module  for  the  terminal  similar  to  the  one  in 
(14, 101V52CHA.MAC.  Then  assemble  the  module.  Include  the  new 
module  in  the  DDL  file  and  i*jbulld  RMD. 
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CHAPTER  7 
SETTING  UP  AND  RUNNING  THE  QUEUE  MANAGER 


This  chapter  Is  directed  to  the  system  manager  or  operator  who  will  b« 

setting   up   and   running  the  Queue  Manager  and  batch  processors  on  an 

RSX-llM  or  RSX-llM-PLUS  system.   Except  where  noted,  all   commands  in 
this  chapter  are  privileged. 

Most  RSX-llM/M-PLUS  systems  will  include  the   Queue  Manager   for   the 
convenience  of  multistream  line  printer  spooling. 


The  Queue  I4anager  on  RSX-llM-PLUS  also  supports  transparent  spoolin^o^ 

and  batch  processing.   You  can  have  the  Queue  Manager  without  batchi 

processing,  but  you  cannot  have  batch  processing  without  the  Queue 
Manager. 

In  UFD  [1,2]  on  the  system  disk  (LB:),  you  will  find  the  file 
STARTUP.CMD.  This  file  includes  commands  for  setting  up  the  Queue 
Manager  on  a  standard  configuration.  This  sets  up  the  QMG  subsystem 
on  a  baseline  system  with  one  print  processor,  and*  on  R8X-11M-PLU8^J 
systems,  one  batch  processor.  The  information  in  the  present  chapter 
will  help  you  alter  STARTUP.CMD  to  set  up  a  Queue  Manager  tailored  to 
your  installation. 

This  chapter  consists  of  a  narrative  introduction  and  review  of  the 
process  of  setting  up  the  Queue  Manager  and  batch  processors  and 
detailed  descriptions  of  all  commands  to  the  Queue  Manager. 

The  queue  management  subsystem  consists  of  three  major  components  on 
RSX-llM.   RSX-llM-PLUS  systems  have  a  fourth  major  component.  Here 

are  the  components: 

A  command  line  interpreter  (QMGCLI)  that  processes  both  print  requests 
and  queue  access  commands  as  described  in  the  RSX-llM/M-PLUS  Batch  and 
Queue  Operations  Manual .  QMGCLI  communicates  with  the  Queue  Manager 
by  sending  data  packets  to  it. 

The  Queue  Manager  (QMG)  that  controls  the  queueing  and  dequeueing  of 
print  jobs.  QMG  communicates  with  QMGCLI  and  the  despooler  tasks  to 
process  print  jobs. 

The  despool  prototype  task  (LPP)  that  attaches  a  device  and  despools 
print  jobs  to  it.  An  LPP  must  be  installed  for  each  device  to  be  used 
as  a  spool  device  with  the  task  name  ddn,  where  dd  is  the  generic 
device  name  and  n  is  the  unit  number.  A  despool  device  is  a  device 
under  the  control  of  QMG. 

On  RSX-llM-PLUS  systems  only,  QMC  also  controls  batch  processing.  The 
RSX-llM-'^LUS  QMGCLI  accepts  batch  requests  as  well  as  print  requests. 
The  RSX-llM-PLUS  QMG  controls  the  queueing  and  dequeueing  of  batch 
jobs.  The  RSX-llM-PLUS  QMG  also  includes  a  batch  processor  prototype 
task,  BPR.  This  task  creates  a  virtual  terminal  that  passes  commands 
to  the  batch  processor  and  to  a  system  CLI,  either  MCR  or  DCL,  or  a 
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U8«r>writt*n  CLI.  (Not*  that  QMGCLI  Is  not  a  CLI  in  thia  aansa.)  Tha 
BP^  taak  can  ba  installad  as  many  as  16  tinas  with  task  nai..as  in  the 
torn  BAPnr    whara  nnn  raprasants  ona  to  thraa  Radix-SO  charactars  , 

On  RSX-llM-PLUS  only,  tha  source  files  in  SYOj [121,101  make  up  the 
print  processor  task.  You  can  use  this  as  a  modal  if  you  wish  to 
write  output  daspoolers  for  your  applications. 


7.1   INTRODUCTION  AND  REVIEW 

The  followinq  narrative  explains  how  to  bring  QMG   into  your 
Both  MCR  and  DCL  commands  are  included. 


system, 


This  can  be  done  interactively,  but  in  most  cases  you  will  include  it 
in  an  indirect  command  file  invoked  as  part  of  the  system's  STARTUP 
procedures. 


NOTE 

On  RSX-llH-PLUS  systems  with  DCL  as  a 
CLI,  the  DCL  form  of  these  commands  can 
be  used  on  both  NCR  and  DCL  terminals. 
This  is  for  compatibility  with 
RSX-llM-PLUS  VI. 0. 


Each  of  the  following  steps  includes  a  block  diagram  of  the  Queue 
Manager,  processors,  and  devices  as  they  exist  at  that  point  in  the 
procedure.  Those  parts  of  the  subsystem  brought  into  being  by  that 
step  ar--  shown  in  red. 

1.   Install  the   Queue   Manager.    Tt   will   be   found   with   the 
privileged  utility  tasks. 

DCL>INSTAr,L/CHECKPOINT  SQMG 

MCR>INSTALL  $QMG/CKP=YES 


QUEUE 
MANAGER 


StOPP**!! 


>  SUBMIT 


^ 


>  PRINT 
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Start  O'lG.  The  command  starts  the  Queue  Manager  an^i 
Initialize  the  default  queues  PRINT  and  BATCH.  Tt  creates 
the  queue  file  on  LBO:  tf  the  file  is  not  there.  The 
command  also  clears  all  assignments  previously  recorded.  If 
the  queue  file  was  intact,  all  queues  will  still  contain 
their  jobs,  but  are  not  assigned  to  processors.  (Processors 
will  have  to  be  reinitialized,  but  queues  will  not.) 


DCL> START/ OUEUE/MANAGER 
MCR>OUE  /STA:OMG 


QUEUE 
MANAGER 


Queup 
PRINT 


I 


>  PRINT 


» 
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3.  The  defauj  ^.  print  queue  PRINT  was  lnltlallze(l  in  the  previous 
step,  but  you  must  initialize  at  least  one  more  queue  named 
for  each  line  printer.  This  queue  will  serve  the  many  system 
tasks  that  conventionally  send  output  to  LP:  by  directing 
this  output  to  OMG.  This  is  known  as  a  device-specific 
queue.   PRINT  is  a  general  queue. 

A  device-specific  queue  must  be  initialized  before  the 
associated  device  is  initialized  (spooled).  For  LPO:,  the 
device-specific  queue  is  named  LPO. 

DCL>IN1TIAI,I7.  F/QURUE  LPO/ PRINT 

MCR>nUE  LPn:/CR:P 


QUEUE 
MANAGER 


>  SUMMT  '  >  PRINT  ' 

Initialization  names,  creates,  and  starts  a  queue. 

You  will  need  this  extra  queue  even  if  your  system  has  only 
one  printing  device.  You  can  initialize  as  many  as  14 
additional  print  queues  for  a  total  of  16.  One  must  be  the 
default  queue  PRINT.  The  remaining  15  can  be  device-specific 
or  general  queues.  There  must  be  a  device-specific  queue  for 
every  spooled  (initialized)  output  device.  Queues  for 
application  processors  are  print  queues. 
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Now  you  must  install  the  print  processors.  You  must  install 
a  print  processor  for  each  physical  printing  device  that  will 
be  set  spooled  (by  means  of  INITIALIZE).  This  processor 
"owns"  the  printer;  the  processor  name  must  be  derived  from 
the  printer  name.  LPO:  is  owned  by  LPn.  LPP.TSK  installs 
automatically  as  LPO.  The  print  processors  will  be  found 
with  the  privileged  utility  tasks. 

DCL>INSTALL  SLPP 

MCR>INS  SLPP 


QUEUE 
MANAGER 


Queue 
PRINT 


Queue 
LPO 


>  print' 


If  you  have  additional  output  devices,  use  the  /TASK 
qualifier  to  install  their  print  processors  under  the  proper 
navies.  You  can  initialize  as  many  as  15  print  processors. 
Applications  processors  are  considered  print  processors  for 
this  count. 

DCL>INSTALL/TASK:LP1  SLPP 

MCR>INS  $LPP/TASK=LP1 
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You  must  initialize  your  print  processors,  setting  whatever 
«ttribu^es  you  wish.  Any  initialization  of  a  print  processor 
sets  the  issoclated  output  device  spooled. 

DCL>INITIALIZR/PR INTER  LPO/FLAGPAGE : 2/FORM : 0/LOWFRCASE 
•1CR>0UE  LPOi/SP/FLcP/FOin/L^W 


p^^^>=»in 

QUEUE 
MANAGER 

LPO 

~       LPO 

^—    —    _ 

^     ^_    ^i_ 

•«MM         MP* 

^ 

M.         M^        ^^» 

n 

Quru* 
BATCH 

Citwuc 
PRINT 

1 

PRINTS 
PRINT 

\ 

QuMtt 

\ 

FCS 

LPO 

\^ 

\ 

>  SUWIT  -^  pp,^^ 


The  command  assigns  the  queue   LPO   to   despooler   LPO. 
queue  must  exist  before  you  initialize  the  processor  LPO 


2K  iM.at 
The 
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Next,  ^you   must   Install   the   interface   between   the   Queue 
Manager  and  other  system  tasks.   This  interface  is  handled  by 

$OMGPRT.TSK.   It  must  be  installed  as   PRT It   will   be 

found  with  the  nonpr ivi leged  utility  tasks. 

DCL> INSTALL/TASK: PRT.. .  $QMGPRT 
MCR>INS  $QMGPRT/TASK=»PRT.  .. 


Queue 
BATCH 


'I 


>  SUBMIT 


PRT,. 


PRINTS 
PRINT 


>  PRINT 
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7.  Now,  you  must  assiqn  queues  to  print  processors.  Assignment 
establishes  the  path  between  queue  anrl  print  processor.  Th« 
Queue  Manager  can  send  jobs  only  to  assigned  processors. 

DCL>AF!SIGN/OUEUE  PRINT  LPO 

MCR>OUE  LPO: /AS: PRINT 


QUEUE 
MANAGER 


IPC 


Oil*  ur 
PRINT 


OlMUC 

LPO 


PRT 


PRINTS 
PRINT 


FCS 


>  PRINT 


Since  queue  LPO  was  assigned  to  processor  LPO  at 
initialization,  this  means  two  queues  are  being  assigned  to 
the  same  processor. 

You  can  assign  a  queue  to  more  than  one  processor  and  you  can 
assign  more  than  one  queue  to  a  processor. 

If  you  initialize  a  queue,  but  do  not  assign  it,  jobs  sent  to 
that  queue  will  not  be  processed  until  the  queue  is  assigned. 

This  completes  the  installation  process  for  the  RSX-llM  QMG. 
The  r««ainlng  steps  apply  to  R8X-11M-PLUS  only. 
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8.   You  must  now  Install  tha  batch  processor, 
found  with  tha  privileged  utility  tasks. 

DCL>INSTALL  SBPR 

MCR>INS  $BPR 


This  task  will  be 


1 

P=;^:>-^ 

OUEUf 
MAKAGER 

LPO 

H 

u 

LPO: 

.^    ._    . 

i_    __    ^_ 

_    _ 

,^ 

.. 

n 

QuctM 

Qmu* 
PRINT 

1 

PRT... 



PRINTS 
PRINT 

BATCI 

\i 

\ 

OlMU* 

\ 

FCS 

LPO 

M 

\ 

^1 


>  SUBMIT'  >  PRINT  ^ 

BPR.TSK  installs  automatically  as  BAPO. 

You  can  install  as  many  as  16  batch  processors 
have  names  in  the  form  BAPn. 


They  must 


» 
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9.   Now  you  InltUllze  the  batch  processors. 

DCL>I>II/BATCH_PROCESSOR  BAPn 
MCR>OUE  BAPO: /BATCH 


BAK 


QUfUE 
MANAGfR 


Outut 
BATCH 


^1 


LPO 


Qu*u» 

rniNT 


IPO 


>  SUBMIT 


PUT 


PWINTt 
PHINT 


FCS 


>PHINT 
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10.   The    default    queue  BATCH    was     initializerl     by 

START/QUEUE/MANAGER,   but  you   may   initialize  as  many  as  15 

adcitlonal   batch   queues  with   names  of   as  many   as   six 

alphanumeric  characters  in  any  form. 

DCL>INI/0  POGO/BATCH 

MCR>OUE    rOGO:/CR:B 


BAPO 


• 


>  SUBMIT 


QUEUE 
MANAGER 


LPO 


OlMU* 

BATCH 


Ou-ue 
POGO 


PUT 


PRINTS 
PRINT 


Frs 


>  PRINT 


Note  that  batch  processors  do  not  need  device-specific  queues 
because  no  devices  are  associated  with  them. 
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11.   Finally,  you  must  assign  batch  quauas  to  batch  procassors, 

DCL>ASSIGN/0  BATCH  BAPO 
MCR>OUE  BAPO: /AS  .'BATCH 


SAW 


QUEUE 
MANAQIR 


LPa 


^  SUBMIT 


PNINTt 
.PNINT 


FCS 


>P»«»(T^ 


If  you  initialize  a  queue  but  do  not  assign  it  to  a 
processor,  jobs  can  be  queued,  but  will  not  be  processed 
until  the  queue  is  assigned. 


7.2   QUEUE  MANAGER  COMMAND  DESCRIPTIONS 

The  operations  of  QMG  are  controlled  through  a  number  of  DCL  and  *1CR 
commands.  The  functions  invoked  are  identical,  but  the  command  syntax 
is  different.  Use  whichever  command  syntax  you  are  accustomed  to.  Tn 
this  manual,  both  forms  of  the  syntax  appear  in  the  command 
descriptions.  The  DCL  commands  and  command  elements  are  to  the  left 
and  the  MCR  to  the  right.  Tn  the  section  titles,  ^""R  commands  or 
command  elements  appear  in  parentheses.  Tn  the  examples,  commands  are 
identified  explicitly  by  the  DCL>  and  MCR>  prompts. 

The  processors,  devices,  a 
derived  from  the  name  o 
spooled  device,  the  proces 
device-specific  queue  is 
the  device  name  can  be  oni 
processors,  devices,  -ir,] 
in  references  in  MCR  comma 
can  include  the  colon  po 
only  in  MCR  commands.  Fur 
be  terminated  by  a  colon 
or  not,.  Thus,  if  you  wish 
command,  you  must  refer  to 


nd  device 

-spe 

cific   queues 

all 

have   names 

f  the  spo 

oled 

device . 

Thus 

,  if 

LPl:   is 

the 

sor  that 

"owns"  it  is 

call 

ed   LPl   and 

the 

also  ca 

lied 

LPl.   Th 

e  col 

on  (  : 

)  po  r  t  i  o 

n  of 

tted  from 

re 

ferences 

in 

JCL 

commands 

to 

qiieues. 

The 

colon  po 

rtion 

must 

be  incl 

uded 

nds  to  processors,  devices. 

and 

queues . 

You 

rtion  in 

any 

DCL  comma 

nd,  but  it 

IS  requ 

ired 

ther,  in 

MCR 

commands. 

all 

queue 

names 

must 

,  whether 

the 

y  are  der 

ived 

from 

device  names 

to  refer 

to 

a  queue  named 

XPRES 

S  i  n  an 

MCR 

that  queue  as  XPRESS: 

• 
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The  general  format  of  DCL  QMG  commands  l.s: 

DCL>DCLcommand/OMGqijal  i  f  ier  '  si  parameter  t »]  [/qual  i  f  ier  rs]  1 
The  general  format  of  *4CR  QMG  commands  is: 

MCR>0UE  ddnn:   /f unction f toptlonf si ) f/swf si  1 

Command  descriptions  are  given  in  the  order  they  are  used  in  the 
narrative,  except  that  any  counteracting  commands  are  described  just 
after  the  set-up  commands  they  counteract. 

7.2.1   INITIALIZE/  (QUE  /CR/SP) 

These  commands  create,  name,  and  start  a  queue  or  processor. 

When  you  initialize  an  output  processor,  you  are  setting  its 
corresponding  device  spooled.  A  spooled  device  can  be  accessed  by  the 
Queue  Manager.   The  processor  or  task  must  be  installed. 


7.2.1.1   INITIALIZE/QUEUE  (QUE  /CR)  -  INITIALIZE/QUEUE  creates,  names, 
and  starts  a  queue. 

Format 

DCL> INITIALIZE/QUEUE  queuename/qual i f ier 

DCL  Parameter  Qualifiers 

/BATCH 

/PRINT 

MCR>OUE  ddnn:/CR:typ 

MCR  Queue  Types 

PRINT 
BATCH 

Parameter 

queuename 

Specifies  the  name  of  the  queue  to  be  initialized. 

Queue  names  BATCH  and  PRINT  are  reserved,  because  the  BATCH  and 
PRINT  queues  are  initialized  by  the  START/OUEUE/MA"\GER  (QUE 
/STA:QMG)  command. 

The  queue  named  BATCH  is  initialized  on  RSX-llM  systems,  but  is 
not  used,  and  is  not  accessible  or  displayed. 

You  must  initialize  a  queue  for  every  output  device  to  which  the 
Queue  Manager  is  to  send  print  jobs.  These  are  called 
device-specific  queues. 

Otherwise,  any  six  alphanumeric  characters  make  an  acceptable 
queue  name  for  a  general  queue.  If  you  have  no  processor  LPl, 
LPl  is  then  a  general  queue  name. 

Device-specific  queues  must  be  initialized  before  the  associated 
processor . 
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Parameter  Qualifiers 

This  qualifier  can  be  cithAr  /ttATCH  or  /PRINT.  The  qualifier 
tells  the  Queue  Manager  what  kind  of  queue  is  being  initialized. 
Queues  for  applications  processors  are  print  queues. 

The  default  qualifier  is  /PRINT.  For  the  sake  of  clarity,  you 
should  always  include  the  qualifier  when  initializing  a  queue. 


Examples 


DCL>INITIALIZE/QUEUE  XPRESS/PRINT 

MCR>OUE  XPRESS:/CR:PRINT 

This  example  creates,  names,   and   starts   a   print   queue   named 

XPRESS.    The   queue  can   now  accept  print  jobs,  but  it  must  be 

assigned  to  an  output  processor  before  jobs  can  be  taken  from  the 
queue. 

DCL>ASSIGN/OUEUE  XPRESS  LPO : 

MCR>QUE  LPO:/AS:XPRESS 

This  command  assigns  the  queue  initialized  in  the  previous 
example  to  a  print  processor. 

DCL>INITIALIZE/OUEUE  LPO/PRINT 
DCL>INITIALIZE/PRINTER  LPO: 

MCR>OUE  LPn:/CR 
MCR>QUE  LPO:/SP 

This  example  creates,  names,  and  starts  a  print  queue  named  LPO. 
This  is  a  device-specific  queue.  Its  name  is  derived  from  the 
name  of  an  output  device.  This  queue  must  be  initialized  before 
the  output  device  despooler  can  be  initialized.  After  both  the 
queue  and  output  device  despooler  are  initialized,  the  queue  can 
accept  print  jobs  and  the  named  printer  is  set  spooled.  Jobs  can 
be  placed  in  the  queue. 

Notes 

No  more  than  Ifi  print  queues  (Including  queues  for  applications 
processors)  can  be  initialized. 

On  RSX-11M-PLU8,  no  aor*  than  1^  batch  quaues  can  ba  initial izad. 

These  counts  Include  the  default  PRINT  and  BATCH  queues. 

7.2.1.2  INITIALIZE/PROCBSSOR  (QUE  /SP)  This  command  creates,  names, 
and  starts  an  output  despooler  or  batch  processor.  When  you 
initialize  an  output  despooler,  this  task  "owns"  a  hardware  device. 
This  is  setting  the  device  spooled.  A  spooled  device  can  be  accessed 
by  the  Queue  Manager. 
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Poraat 


OCL>INITIALIZB/pcoc«asortyp«  procassorname/ [/qual i f ier |   I 

MCR>OUE  pcoc«ssornan«:/SP(/SM(a] 1 

DCL  Pi'ocaasot  Typ««  NCR  Punction  I 


/PROCESSOR 

/SP 

/PRINTER 

/SP 

/DEVICE 

/8P 

/MtCH  PIOCBSSOK'flHBBHI 

■■m 

/APP    i7at I ONSPROCBSflOR 

/BP/EX 

DCL  Qualifiars 

NCR   Switch** 

/FLAG   PAGE:n 

/FL:n 

/LOWERCASE 

/LOW 

/UPPERCASE 

/NOLO 

/FORMS : n 

/PO:n 

/SHAREABLE 

/SHn 

Proc«ssoc  Typ*a  I 

/PROCESSOR  (/SP) 
/PRINTER  (/SP) 
/DEVICE      (/SP) 

The  DCL.  processor  types  fall  in  thrnc  groups.   One  group  consists   I 
of   /PROCESSOR,  /PRINTER,  and  /DEVICE.   These  three  are  synonyms. 
The  effect  of  each  is  the  same.   The   synonyms   are  provided   to 
assure   unambiguous  commands  and  documentation.   Use  /PRINTER  for 
line  printers  and  /DEVICE  for  other  output  devices. 

If  you  use  one  of  these  three  synonyms,  a  device-specific  queue 
must  exist  before  the  output  despooler  tas)c  can  be  initialized. 
See  Notes. 

The  NCR  /SP  switch  performs  the  same   function.    There  are  no 

synonyms   in   the  NCR   form   of  this  command.   A  device-specific 

queue  must  exist  before  the  output  despooler  task  can  be 
initialized.   See  Notes. 


I  /BATCM_P>0CI8SOR  (/BA) 

OS*  this  proe***oc  typ*  (vc  optior>  wiMn  inltialiiing  a  batch 
^     pcoc***OE . 

/APPLICATIONSPROCESSOR  (/SP/EX) 

Use  this  processor  type  «fhen  the  destination  of  the  output  is  not 
a  physical  device,  but  rather  some  software  application.  Use 
/APPLICATI0NS_PROCESS0R  when  you  are  initializing  a  user-written 
output  despoolev  for  which  the  physical  device  is  not  currently 
in  the  system.  This  makes  it  possible  for  the  Queue  Manager  to 
despool  output  to  an  applications  task,  to  a  network,  or  to  some 
other  instance  of  down-line  loading. 

In  MCR  format,  you  must  combine  the  /SP  and  /EX  options. 
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Whan  you  use  this  command  in  either  form,  the  Queue  Manager  does 
not  check  for  the  existence  of  a  physical  device  before 
initializing  the  processor. 


Pacaaeter 

processornam«j 

Remember,  the  names  of  the  device,  processor,  and  queue  are  the 
same,  and  interchangeable.  MCR  users  must  include  the  colon 
(  :  )  but  DCL  users  can  omit  it. 

You  must  initialize  device-specific  queues  before  you  initialize 
the  print  processor  with  the  same  number. 

If  initialising  a  batch  procaaaocr  itc  naaa  must  ba  In  tha  Corn 
BAPn. 

4 

f   DCL  Qualifiers  and  MCR  Punctiona 

These  qualifiers  and  functions  have  meaning  for  initializing 
print  procesKocs  only. 

With  the  exception  of  setting  the  number  of  flag  pages,  these 
qualifiers  have  no  effect  on  tlie  printed  output  of  the  printer 
being  initialized.  Rather,  these  qualifiers  define  the  kind  of 
print  jobs  the  processor  can  accept. 

Different  kinds  of  print  jobs  are  established  by  the  PRINT 
command  which  places  them  in  the  queue. 

/FLAG_PAGE:n  (/FL:n) 

Specifies  how  many  flag  pages  are  to  precede  jobs  and  files 
printed  by  this  processor.   Default  is  0;   n  must  be  0,  I,  or  2. 

If  the  processor  is  being  initialized  to  accept  special  forms, 
you  may  want  to  set  this  qualifier  to  0. 

If  you  wish,  you  can  change  the  value  set  here  with  the  /FLAG 
qualifier  to  fie  START/  command  (/FL  switch  to  /STA  option) . 

/LOWERCASE  (/LOW) 

If  you  initialize  a  printer  as  lowercase,  that  printer  will 
accept  print  jobs  with  lowercase  or  uppercase  specified  in  the 
PRINT  command.  Normally,  you  should  not  use  this  qualifier 
unless  the  hardware  involved  has  both  the  up|.ercase  and  lowercase 
e       character  sets. 

/OPPERCA.'iE  (/NOLO) 

If  you  initialize  a  printr.'r  as  uppercase,  that  printer  will  not 
accept  print  jobs  with  loworcase  specified  in  the  PRINT  command. 
Normally,  you  should  not  use  this  qualifier  unless   the  hardware 

(involved  does  not  have  the  lowercase  character  set.  This  is  the 
default. 

/FORMS :n  (/FO:n) 

This  number  can  be  anything  from  0  through  255.  The  default  is 
0. 

These  numbers  are  to  be  specified  by  your  users  in  their  PRINT 
conmands. 
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You  should  determine  which  forms  will  be  used  on  your  system  and 
assign  each  a  number.  You  should  then  edit  the  file 
LB: (1,24]LPPBLD.CHD  to  set  up  the  forms  table  for  the  print 
processor  to  correspond  to  the  numbers  you  have  assigned  to  the 
forms.   Then  you  must  build  the  processor. 

If  the  right  forms  are  not  in  an  available   printer,  then   their 

jobs  will   be  waiting   until   the  printer  has  been  stopped,  the 

proper  forms  put  in  place,  and  the  printer  restarted  with  a  new 
value  for  /FORMS  (/PO) . 

Forms  differ  by  their  length  and  width.  Both  values  can  be  set 
in  the  forms  table. 

Setting  width  is  simply  a  matter  of  determining  how  ma.iy  columns 
are  needed  to  fill  in  the  form.  There  are  no  standard  widths  for 
forms,  but  SO  and  132  are  the  most  common. 

Setting  length  requires  you  to  determine  whether  your  forms  are 
of  a  standard  length. 

"Standard  length"  is  any  form  length  that  can  be  set  on  your 
printing  hardware.  If  the  hardware  can  handle  the  form  by 
setting  a  response  to  a  form-feed  character,  then  it  is  a 
standard  length  form,  and  the  form  feed  is  a  "real,"  that  is, 
hardware,  form  feed. 

If  the  form  length  cannot  be  set  on  the  hardware,  then  it  is  a 
nonstandard  length.  In  this  case,  the  form  feed  must  be  replaced 
by  an  appropriate  number  of  line  feeds.  This  is  called  a 
"simulated,"  that  is,  software,  form  feed. 

The  following  table  shows  the  forms  requirements  for  a 
hypothetical  installation.  The  form  names  describe  different 
uses  that  special  forms  might  be  put  to,  but  have  no  significance 
otherwise. 

Pora       Assigned  n    Width 

Accordion  0  132 

Paychecks  1  40 

Invoices  2  M 

Stationery  3  tO 

Moon  Diary  4  22 

Star  Log  S  112 

The  forms  table  can  be  changed  at  LB: ( 1,24] LPPBLD.CMD.  This 
procedure  is  explained  in  the  comments  in  this  file. 

As  shipped,  FORMS: 0  is  66  lines  long  by  132  columns  with  real 
form  feeds.  FORMS:!  Is  1  line  long  by  132  columns  with  simulated 
form  feeds;  P0RHS:2  is  2  lines  long  by  132  columns  with 
simulated  form  feeds;  and  so  on  through  FORMS: 66  which  is  66 
lines  long  by  132  columns  with  simulated  form  feeds.  The 
remaining  PORMS:n  entries  are  set  to  1  line  long  by  132  columns 
with  simulated  form  feeds.  Thus,  if  you  specify  /PORMS:43,  when 
the  printer  encounters  a  form  feed,  it  will  count  the  number  of 
lines  on  the  page  and  subtract  that  number  from  43.  The  printer 
will  then  reel  off  a  number  of  line  feeds  equal  to  the 
difference.  You  may  find  this  arrangement  satisfactory  if  your 
installation  rarely  uses  forms  other  than  standard  line-printer 
paper,  but  if  you  have  more  than  one  standard  form,  you  will 
probably  want  to  make  the  changes  in  the  forms  table  entries. 
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/SHAREABLE  (/SHR) 

Establisheb  the  processor  as  shareable.  This  means  the  physical 
device  is  not  "owned"  by  a  processor  if  it  is  not  printing  a  job. 
Normally,  the  output  processor  attaches  the  device  when  it  is 
initialized  and  no  other  job  can  access  the  device  until  it  is 
detached . 

If  you  initialize  the  processor  as  shareable,  tha  device  is 
attached  at  the  beginning  of  the  QMG  print  job  and  detached  at 
the  end  of  the  job,  leaving  the  device  free  for  other  uses. 

On  MX-llN-rLINIf  If  you  initialia*  a  pcoo«SBor  as  aharttablar 
transparent  apooling  to  that  davica  will  not  work. 

Bxaaplas 

DCL>INITIALIZE/PROCESSOR  LPO: 

»1CB>QUE  LPC:/Sr 

LPO:  is  sot  spooled.  Jobs  can  be  passed  to  it  from  the  Queue 
Manager  . 

You  must  initialize  a  ci<ev\c«-specif i.  queue  named  LPO  before  you 
can  initialize  the  processor  .'or  device  LPO:. 

DCL>INITIALIZE/PRINTER  LPl : /FLAG_PAGE : 2 

MCR>QUE  LP1:/SP/FL:2 

This  command  initializes  a  print  processor  to  control  LPl:  and 
specifies  that  jobs  run  on  this  printer  will  be  preceded  by  two 
flag  pages.  Jobs  specifying  flag  pages  in  the  PRINT  command  will 
have  two  flag  pages  at  the  head  of  the  job. 

DCL> INITIALIZE/PRINTER  LPl/NOLOWER 

MCR>OUE  LP1:/SP/N0L0W 

This  command  initializes  a  print  processor  to  control  LPl:  and 
states  that  the  printer  will  only  accept  jobs  specifying 
uppercase  in  the  PRINT  command. 

OCL>IMI/BATCH_PROCBSSOR  BAPO 

NCR>QOB  BAPOt/BA 

Thia  coaaiand  crsataa,  naaaa,  and  atarta  batch  proeaaaor  BAPO,  on 
an  R8X-11M-PL0S  ayataa. 

DCL>INI/PRO  LP0/FLAG:2/FORMS:0/LOWER 

MCR>OUE  LP0:/SP/FL:2/FO:0/LOW 

This  command  creates,  names,  and  starts  print  processor  LPO.  The 
printer  has  the  lower-case  character  set.  Jobs  will  have  two 
flag  pages  when  printed. 
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Hot** 

No  moEe  than  16  batch  pcocttsmoca  on  an  R8X-)  M-PLUS  aystanir  or  16 
print  processors  (Including  appliccitions  processors)  can  be 
initial ized . 

If  you  are  initializing  an  output  despooler  that  attaches  a 
physical  device,  the  system  (hecks  for  the  existence  of  the 
device  and  of  its  device-specific  queue  before  the  command  is 
executed.   Therefore,  the  following  procedure  must  be  followed. 

1.  The  device  must  be  part  of  the  current  system. 

2.  You  must  initialize  a  device-specific  queue  for  the 
device  before  you  initialize  an  output  despooler  of  the 
same  type  and  number. 

When  you  initialize  an  output  processor,  it  is  named  and 
started  and  has  its  device-specific  queue  assigned  to  it. 

3.  For  each  print  processor,  there  must  be  a  print  queue, 
called  the  device-specific  queue,  with  a  corresponding 
name.  The  printer  named  LPO:  is  owned  by  the  output 
despooler  named  LPO.  There  must  also  be  a 
device-specific  queue  named  LPO.  The  processor  cannot  be 
named  until  the  device-specific  queue  has  been 
initialized.  This  queue  will  be  assigned  automatically 
to  the  processor  whose  name  it  shares,  but  the 
device-specific  queue  can  be  deassigned  and  assigned 
elsewhere  after  initialization. 

This  procedure  does  not  apply  to  initializing  batch 
processors  or  applications  processors.  Neither  a 
physical  device  nor  a  device-specific  queue  is  needed  to 
initialize  a  batch  processor  or  applications  processor. 

There  can  also  be  print  queues  whose  names  do  not 
correspond  to  output  devices.  These  are  called  general 
queues. 

The  lowercase/uppercase  attributes  have  no  effect  on  the  nature 
of  the  printer's  output.  They  do  not  cause  jobs  to  be  printed 
all  uppercase.  These  qualifiers  set  up  a  "mask"  that  must  be 
matched  by  the  attributes  of  print  jobs  before  they  can  be  sent 
to  the  printer.  A  printer  without  the  lowercase  character  set 
can  be  initialized  lowercase  and  it  will  accept  print  jobs  with 
lowercase  specified  in  the  PRINT  command.  This  might  be  done  if 
a  printer  with  the  lowercase  character  set  was  temporarily 
unavailable.  As  a  general  rule,  however,  you  should  only 
initialize  printers  with  the  characteristics  they  actually  have 
to  avoid  confusion. 

(The  line  printer  driver  does,  however,  affect  the  printer's 
output,  through  lowercase-to-uppercase  translation.  See  the 
discussion  of  SET  /LOWER  in  the  RSX- 11 M/RSX- 1 IM-PLUS  MCR 
Operations  Manual,  or  the  discussion  of  SET  DEVICE  /LOWER  in  the 
RSX- 11 M/M- PLUS  Command  Language  Manual.) 


7.2.2   OBLBTI/  (QUE  /DEL) 

You  can  delete  queues  or  processors. 
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7.2.2.1   DILITB/OOBOI  (QOI  /DBLiQ)  -  DELETE/QUEUE   deletes   queues   by 
name. 

rorsata 

DCL>DELBTB/OUEUE  queuename/ERASE 

MCR>QUE  queuename:/DEL:0 

Paraa«t«ra 

queuename/ERASE  (/DEL:Q) 

Specifies  the  name  of  a  queue  to  be  deleted.  Only  a  privileged 
usee  can  delete  a  queue  using  this  parameter.  The  default  queues 
BATCH  and  PRINT  cannot  be  deleted. 

If  the  queue  has  jobs  in  it,  it  will  be  narked  for  delete.  When 
the  last  job  leaves  the  queue,  the  queue  ifself  is  deleted.  No 
new  jobs  can  be  entered. 

You  cannot  delete  device-specific  queues  until  after  you  have 
deleted  the  processor  with  the  same  number.  Se>   next  section. 

Bxaaples 

DCL>DELETE/QUEUE  MONA/ERASE 

MCR>QUE  MONA:/DEL:Q 

This  privileged  command  deletes  the  queue  named  MONA  i  it  is 
empty.  If  the  queue  has  entries,  it  is  marked  for  delete,  and 
will  be  deleted  as  soon  as  the  last  job  is  removed  from  the 
queue.   Note  the  colon  in  the  queue  name  in  the  NCR  example. 


7.2.2.2  DBLBTB/PROCBSSOR  (QOB  /0N8P)  -  DELETE/PROCESSOR  deletes  print 
processors,  output  despoolers,  or  batch  processors  by  name.  The 
command  also  sets  the  device  unspooled. 

Poraat 

DCL>DELETE/processortype  processor name 

MCR>QUE  processorname:/UNSP 

DCL  Processor  Typ«a  NCR  Functions 

/PROCESSOR  /UNSP 

/PRINTER  /UNSP 

/DEVICE  /UNSP 

/mTCH_PR0CBS80R  /OHBA 

/APPLICATIONS_PROCESSOR  /UNSP 

Parameters 

processor name 

For  physical  devices,  the  name  of  the  processor  is  identical  with 
the  name  of   the  physical   device.    Thus,  the  device  LPl:   is 
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controlled  by  processor  LPl : .  DCL  commands  do  not  require  that 
you  include  the  colon  (:),  but  you  must  include  the  colon  in  all 
MCR  commands. 

Batch  processors  have  names  in  the  form  BAPnnn,  where  nnn  is  from 
one  through  three  Radix-50  characters. 

Applications  processors  have  names  of  six  Radix-50  characters. 

Procassor  Types 

/PROCESSOR  (/UNSP) 

/PRINTER 

/DEVICE 

The  DCL  processor  types  fall  in  three  groups.  One  group  consists 
of  /PROCESSOR,  /PRINTER,  and  /DEVICE.  These  three  are  synonyms. 
The  effect  of  each  is  the  same.  The  synonyms  are  provided  to 
assure  unambiguous  commands  and  documentation.  Use  /PRINTER  for 
line  printers  and  /DEVICE  for  other  output  devices. 

If  you  use  one  of  these  three  synonyms,  the  device-specific  queue 
cannot  be  deleted  until  after  the  output  despooler  task  is 
deleted. 

These  distinctions  do  not  apply  in  MCR. 
/BATCH_PROCBSSOR  (/UNBA) 

0««  this  processor  type  when  deleting  a  batch  processor. 

/APPLICAT10NS_PR0CESS0R  (/UNSP) 

Use  this  processor  type  when  the  destination  of  the  output  is  not 
a  physical  device,  but  rather  some  software  application.  Use 
/APPLICATIONS_PROCESSOR  when  you  are  deleting  a  user-written 
output  despooler. 

Exaaplaa 

DCL>DELETE/PROCESSOR  LPO 

MCR>OUE  LPO:/UNSP 

This  example  deletes  processor  LPO,  the  owner  of  line  printer 
LPO:. 

DCL>DBLETE/BATCH_PROCBSSOR  BAP2 

MCR>QUB  BAP2:/DNBA 

The  conmands  are  equivalent;  they  delete  the  batch  processor 
named  BAP2,  on  an  RSX-llM-PLOS  system.  Note  the  colon  in  the  MCR 
conniand  • 

DCL>DELETE/PROCESSOR  LPO 
DCL>DELETE/QUEUE  LPO/ERASE 

MCR>QUE  LPO:/UNSP 
MCR>QUE  LPO:/DEL:Q 

This  example  shows  the  order  you  must  follow  to  delete  a 
device-specific  queue. 
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Uofm 

DELETE/PROCESSOR  (/UNSP)  counteracts  INITIALIZE/PROCESSOR  (/SP) . 

For  maximum  clarity,  operators  using  DCL  should  use  the  specific 
qualifiers  /PRINTER  and  /DEVICE  rather  than  the  synonym 
/PROCESSOR  when  deleting  output  despoolers. 

7.2.3   ASSIGN/QOBOB  (QUE  /AS:) 

ASSIGN/QUEUE   (QUE  /AS:)   establishes  a  path   from  a  queue   to  a 
processor . 

Foraat 

DCL>ASSIGN/QUEUE  queuename  processorname 

MCR>OUE  processorname :/AS :queuename 
Paraaeters 
queuename 

Specifies  the  queue  th£.t  is  to  be  assigned  to  the  processor. 
proceF  iorname 

Specifies  the  processor  to  which  the  queue  is  to  be  assigned. 

When  assigning  queues  to  output  devices,  use  the  the  device  name 
in  the  form  ddnn  : . 


notes 


This  command  can  be  used  to  redirect  output  from  one  processor  to 
another . 

Other  uses  include  grouping  related  processors,  such  as  plotters, 
under  a  single  queue. 


7.2.4   DBAS8IGN/Q0B0B  (QOB  /DBA) 

DEASSIGN/QUEUE  (QUE  /DEA)  counteracts  ASSIGN/QUEUE  (/AS).   It  is   used 
to  eliminate  the  path  from  a  queue  to  a  processor. 

Foraat 

DCL>DEASSIGN/QUEUE  queuename  processorname 

NCR>QUE  processorname :/DEA :queuenaroe 
Paraa«t«rs 
queuename 

Specifies  the  queue  that  is  to  be  deassigned  from  the  processor. 
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ptocmu»otn»mm 

Specifics  th«  procassor  from  which  the  queue  it  to  be  deassigned. 

When  deassigning  queues  from  output  devices,  use  the  device  namu 
in  the  form  ddnn:. 

7.2.S  STOP/  (GOB  /STO) 

STOP/  (/STO)   is   used   to  stop  queues,   the  Queue  Manager,   or   a 
processor. 

7.2.5.1   STOP/QOEOB  (QOE  /STO:QOB)  -  STOP/QUEUE  stops  queues. 
Per mat 

DCL>STOP/OUEUE  queuename 

MCR>QUE  queuename :/STO:QUE 

Paraaeter 

queuename 

Specifies  the  queue  to  be  stopped.  Following  the  command,  no 
jobs  will  be  taken  from  the  queue,  but  jobs  can  still  be  added  to 
the  queue. 

If  a  job  is  active  at  the  time  this  command  is  issued,  the  job 
will  be  allowed  to  complete  processing  but  no  further  jobs  will 
be  dequeued . 

Note  the  colon  (:)  in  the  MCR  form  of  the  command. 


7.2.5.2  ST0P/Q0B0B/HAIiAC3!R  (/STOtQNG)  -  STOP/QUEUE/MANAGER  (/STO:QMG) 
stopti  the  Queue  Manager  and  deletes  all  processors,  whether  batch 
processors  or  output  despoolers. 

Poraat 

DCL>STOP/QUEUE/MANAGER [/ABORT] 

MCR>QUE  /STO:QMG[:AB] 

Motes 

If  you  issue  this  command  without  the  /ABORT  (:AB)  qualifier,  QMG 
is  marked  for  stop.  As  soon  as  all  currently  active  jobs  on  all 
processors  are  done,  QMG  will  stop.  No  more  jobs  can  be  entered 
in  the  queue.   See  also  example  in  Section  7.2.6.2. 

If  you  include  the  /ABORT  {:AB)  qualifier,  all  active  jobs  are 
held  immediately  and  QMG  e:tits  without  further  delay. 
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7.2.5.9  8T0V/»M>CI8S0I  (OOI   /8T0)  -  STOP/PROCBSSOR   (/STO)   Stops   a 
procasaoc. 


Poraat 

DCL>8TOP/proc«ssortyp« 

nCR>OUE  proc««aornam«:/STO[ :opt) 

DCL  Procasaor  Typaa 

/PROCESSOR 

/PRINTER 

/DEVICE 

/APPLICATIONS  PROCESSOR 

/BitTCH_PitOCB8iOR 

DCL  Pacaaatar  Qaalifiara 

/PAUSE 
/JOBEND 
/PILE_END 
/ABORT 

Paraaatar 

processorname 

When  stopping  print  processors,  use  the  device  name  in   the   forn 
ddnn: . 


procassornasM  [/qual i  f iar ] 


NCR  Punctiona 

/STO 
/STO 
/STO 
/STO 
/•TO 

NCR  Optiona 

<no  equivalent> 

:EOJ 

:EOF 

:AB 


This  command  has  no  effect  on  the  status  of  ]obs  in  queues, 
no  jobs  will  be  dequeued  while  the  processor  is  stopped. 


but 


■   Pcocaaaor  Typaa 

/PROCESSOR  (/STO) 

/PRINTER 

/DEVICE 

I  The  DCL  processor  types  are  synon/ros.  The  effect  of  each  is  the 
same.  These  synonyms  are  provided  to  assure  unambiguous  commands 
and  documentation.  Use  /PRINTER  for  line  printers,  /DEVICE  for 
other  output  devices,  and  /BATCH_PR0CB8S0R  foe  batch  procaaaocs. 
MCR  users  use  /STO  across  the  board. 

/BATCH_PROCBSSOR  (/STO) 

I       Uaa  thia  procaaaor  typa  whan  atopping  a  batch  processor. 

/APPLICATIONS_PROCESSOR  (/STO) 

I  Use  this  processor  type  wher  the  destination  of  the  output  is  not 
a  physical  device,  but  rather  some  software  application.  Use 
/APPLICATIONS  PROCESSOR  when  you  are  stopping  a  user-written 
output  despooTer. 
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Qaallfiara 


Only  on*  qualifier  ia  parmittad.  The  choice  of  qualifier  here 
affecta  the  reatarting  of  joba  when  the  procenaor  ia  atarted 
again. 

/PAUSE  <no  equivalent> 

Thia  ia  the  default;  it  caueea  the  proceaaor  to  atop  at  the  end 
of  the  current  line.  There  ia  no  NCR  qualifier;  /STO  ia 
auf f icient. 

/JOBEND  (:EOJ) 

Cauaea  the  proceaaor  to  atop  at  end  of  the  current  job. 
/FILE_END  (:EOF) 

Cauaea  the  processor  to  stop  at  end  of  the  current  file. 

/ABORT  (:AB) 

Causes  the  processor  to  atop  immediately.  The  current  job  is 
held  in  its  queue. 


Notea 


This  command  is  counteracted  by  START/PROCESSOR  (/STA) .  You 
cannot  issue  START/PRCKIESSOR  (/STA)  until  the  processor  actually 
stops. 


7.2.5.4  STOP/ABORT  (QOE  /KIL)  -  STOP/ABORT  (/KIL)  deletes  the  active 
job  on  a  given  processor.  Privileged  users  can  delete  any  job; 
nonpr ivileged  users  can  delete  their  own  jobs.  You  do  not  need  to 
know  the  queue  name  or  job  name  to  delete  the  job,  only  the  name  of 
the  processor. 

Foraat 

DCL>STOP/ABORT  processor name 

MCR>QUE  processorname:/KIL 

processorname 

Specifies  the  processor  whose  active  job  you  wish  to  delete. 
Note  that  the  MCR  conunand  format  requires  a  colon  (:)  after  the 
processor  name. 

You  can  stop  jobs  running  on  any  processor  under  the  control  of 
QMG,  including  RSX-llM-PLUS  batch  processors. 

Examples 

DCL>STOP/ABORT 
Processor?   LPO 

This  example  shows  how  to  stop  a  print  job  on  LPO:  The  currently 
active  job  is  deleted  from  the  queue  and  the  next  eligible  job  is 
queued . 
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■otas 

Use  this  conunand  to  stop  a  processor  fast,  such  as  a  line  printer 
printing  nothing  but  form  feeds. 

As  soon  as  the  active  job  Is  deleted,  QMG  passes  the  next 
eligible  job  to  the  processor.  The  processor  has  not  been 
aborted  or  killed,  only  the  active  job  on  that  processor. 

You  can  also  delete  the  active  job  on  a  card-reader  processor 
with  this  command. 

7.2.6   START/  (QOB  /STA) 

START/  (QUE  /STA)  is  used  to  start  a  queue,  the  Queue  Manager,   or   a 
processor.   START/  (QUE  /STA)  counteracts  STOP/  (/STO) . 

7.2.6.1   START/QOEDE  (QOE   /STA)  -  START/QUEUE   (QUE   /STA)   starts   a 
queue. 

Format 

DCL>START/OUEUE  queuename 

MCR>QUE  queuename :/STA 

Parameter 

queuename 

Specifies  the  queue  to  be  started.  This  command  starts  a  queue 
that  has  been  stopped.   Note  the  colon  (:)  in  the  NCR  format. 


7.2.6.2  START/QOEOE/MANAGER  (QUE  /St-A'QMG)  -  START/QUEUE/MANAGER  (QUE 
/STArQMG)  Starts  the  Queue  Manager,  initializes  the  default  queues 
PRINT  and  BATCH,  and  creates  the  queue  file  LBO: ( 1, 71QUEUE.SYS  if  it 
does  not  exist.  The  command  also  clears  all  queue  assignments.  If 
the  queue  file  was  intact,  all  queues  will  still  contain  their  jobs, 
but  will  not  be  assigned  to  processors. 

Poraat 

DCL>START/QOEUE/MANAGER 
MCR>QUE  /STA: QMG 
Examples 

DCL>START/QUEUE/MANAGER 

MCR>QUE  /STA: QMG 

Starts  Queue  Manager.  Initializes  the  default  queues  PRINT  and 
BATCH,  if  they  are  not  already  initialized.  Clears  all 
assignments  of  queues  to  processors. 
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Any  jobs  that  ware  active  at  the  time  the  Queue  Manager  was 
■topped  will  be  held  when  it  ia  started  again.  All  other  jobs 
retain  the  atatus  they  had  when  QMG  was  stopped. 

All  processors  must  be  reinitialized. 

The  default  queue  BATCH  is  Initialised  on  R8X-11H  •ystmss  as  well 
••  RSX-llM-PLOS,  but  it  is  neither  accessible  nor  displayed. 

DCL>STOP/OUEUE/MANAGER 

MCR>QUE  /STO:QMG 

With  this  command,  the  Queue  Manager  is  stopped,  and  all 
processors  are  deleted. 

DCL>START/QUEUE/MANAGER 
MCR>QUE  /STA:OMG 
This  command  clears  all  assignments  of  queues  to  processors. 

DCL>INITIALIZE/PRINTEK  LPO 
DCL>INITIALIZE/PRINTER  LPl 
DCL>IN1TIALIZE/BATCH_PR0CBSS0R  BAPO 
DCL  INITIALIZE/BATCH  PROCESSOR  BAPl 
DCL->ASSIGN/QUEUE  PRINT  LPO 
DCL>ASSIGN/QUEUE  PRINT  LPl 
DCOASSIGN/QUEUE  BATCH  BAPO 
DCOASSIGN/QOEUB  BATCH  BAPl 

MCR>QUE  LPO:/SP 
MCR>QUE  LPll/SP 
nCR>QUE  BAPO:/BA 
MCR>QUE  BAP1:/BA 
MCR>QUE  LPO:/AS:PRINT 
MCR>gUE  LPl  : /AS : PRINT 
NCR>QUE  BAPO: /AS; BATCH 
NCR>QU^  BAPl: /AS: BATCH 

These  commands  recreate  the  network  of  queues   and   processors.    Note 
that  RSX-llN  systems  have  no  batch  processors. 

DCL>RELEASE/JOB  PRINT  BOBC 

MCR>QUE  PRINT:BOBO/REL 

This  command  releases  a  held  job  that   was   active   at   the   time   the 
system  crashed. 


7.2.6.3   START/PROCESSOR   (QOE   /STA)  -  START/PROCESSOR    (QUE    /STA) 
starts  a  batch  processor  or  output  despooler. 


Poraat 


DCL>START/proces3ortype  pcocessorname  [/qua  1 i f ier [ s] ]        | 
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DCL  rxoettssor  Typaa       DCL  Qoalifi*'* 

/PROCBSSOR  /FORMS : n 

/PRINTIR  /PLAG:n 

/DEVICE  /CONTINUE 

/WhfCM   VaOCIMOR  /RESTART 

/APPLI?ATIONS_PROCESSOR     /NEXT  JOB 

/TOP  5r  PILE 
/BACl^SPXCB:n 
/PORWARDSPACB:n 
/AT  PAGE:n 

/alTgn 

MCR>QUE  proc«ssornam«:/STA ( :opt [■] ] 

NCB  Opt ions 

/FO:n 

/PLrn 

<no  •quival«nt> 

:NE 

:RES 

:PA:0 

:BA:n 

:FW:n 

:PA:n 

/AL 


PacuMtara 

processornana 
ddnn: 

Specifies  the  processor  to  be  started.  When  starting  a  stopped 
output  processor,  use  the  device  name  in  the  form  ddnn:. 

I   Procaasor  Typaa 

/PROCESSOR 
/PRINTER 
/DEVICE 
:  /MTCH_PR0CI880B 

/APPLICATIONS_PROCBSSOR 

These  are  DCL  synonyms.  The  effect  of  each  is  the  same.  These 
synonyms  are  provided  to  assure  unambiguous  commands  and 
documentation.  Use  /PRINTER  for  line  printers,  /DEVICE  for  other 
output  devices,  /JBATCH  PR0CB880K  for  batch  procaaaoKS*  and 
/APPLICATIONS  PROCESSOR  Tor  applications  processors.  In  MCR 
format,  upe  tHe  /STA  option. 

I   Qualifiars 

Some  qualifiers  have  meaning  for  starting  either  batch  or  print 
processors,  and  sonte  have  meaning  for  print  processors  only.  Sea 
descriptive  text. 

I  This  field  is  restricted.  You  can  include  either  /FORMC:  (/FO:) 
or  /FLAG:  (/FL:)  or  both,  or  you  can  include  any  one  of  the 
remaining  qualifiers,  if  permitted. 

I       /FORMS:    (/FO:)   and  /FLAG:    (/FL:)   have  meaning   for   print 
processors  only. 
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/FORMS in  (/PO:n) 

Ov«rrM«s  th«  forns  valu*  act  wh«n  the  procasaor  was  initialii«d. 
n  can  b«  any  number  fcon  0  through  256. 

/FLAGtn  (/PL:n) 

Ovarridaa  tha  flag  value  aet  when  the  proceaaor  waa  initialiied. 

tfhen  the  proceaaor  atarta  again,  the  Queue  Manager  aenda  the  next 
job  that  matchea  the  attrlbutea  of  the  proceaaor. 

/CONTINUE 

Specifiea  that  the  proceaaor  carry  on  front  wherever  it  waa 
atopped.   Thia  ia  the  default.   MCR  format  requirea  no  awitch. 

/RESTART  (:RES) 

Specifiea  that  interrupted  joba  be  reatarted  from  the  beginning 
of  the  file  that  waa  being  proceaaed  when  the  proceaaor  waa 
atopped.  Thia  qualifier  affecta  only  joba  that  were  ACTIVE  at 
the  time  the  proceaaor  atopped. 

Thia  qualifier  may  conflict  with  the  deairea  of  your  uaera  who 
have  apecified  /NORESTART  in  their  PRINT  or  SUBHIT  commanda. 
Thia  qualifier  cauaes  such  joba  to  be  restarted  at  the  atart  of 
the  file  being  processed  when  the  processor  was  stopped.  You 
should  check  the  queue  display  for  such  jobs  before  using  thia 
qualifier.  The  /CONTINUE  (default)  qualifier  will  not  affect 
auch  joba. 

The  action  of  this  qualifier  further  depends  on  the  qualifier  to 
the  STOP/  (/STO)  command  that  atopped  the  processor  in  the  first 
place. 

If  the  qualifier  waa  /PAUSE  (the  default  for  /STO),  then  any  joba 
active  at  that  time  will  be  reatarted  at  their  beginning. 

If  the  qualifier  was  /PILE  END  (:EOF),  then  any  jobs  active  at 
that  time  will  be  restarted  at  their  beginning,  unless  the  active 
file  waa  the  last  one  in  the  job. 

If  the  qualifier  waa  /ABORT  (:AB)  (or  if  the  system  crashed),  the 
current  active  job  was  held  in  its  queue,  so  the  restart 
qualifier  will  have  no  effect. 

Likewise,  if  the  qualifier  was  /JOB_END,  (:EOJ)  there  will  have 
been  no  current  job,  so  the  restart  qualifier  will  have  no 
effect. 

/NEXTJOB  (:NE) 

Specifies  that  the  processor  start  at  the  beginning  of  the  next 
job. 

/TOP_OF_FILE  (:PA:0) 

Specifies  that  the  processor  start  at  the  top  of  the  current  file 
in  the  current  job. 

The  qualifiers  /CONTINUE  (the  default  for  /STA)  ,  /RESTART  (/RES), 
/NEXT_JOB  (/NE) ,  and  /TOP_OF_FILE  (PA:0)  are  appropriate  for  both 
print  and  batch  processors. 
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/BACKSPACE :n  (:BA:n) 

Spacifiea  that  th«  processor  start  n  pcgas  back  in  the  current 
job. 

/FORWARDSPACB:n  (:FW:n) 

Specifies  that  the  processor  start  n  pages  forward  in  the  ci'rrent 
job. 

/PAGE:n  (:PA:n) 

Specifies  that  the  processor  start  at  spacified  page  in  the  job 
that  was  active  when  the  processor  was  stopped. 

These  page-related  qualifiers  have  meaning  for  print  processors 
only.  They  will  have  no  effect  unless  the  user  specified  a  page 
length  qualifier  in  the  PRINT  command. 

/ALIGN  (:AL) 

Informs  the  print  processor  that  the  paper  in  the  line  printer  is 
currently  at  the  top  of  a  form.  It  is  used  when  you  have  stopped 
the  print  processor  to  change  forms.  The  print  processor 
maintains  a  count  of  how  many  lines  it  has  gone  down  on  a  form. 
The  /ALIGN  (/AL)  qualifier  clears  that  count  for  new  forms. 

Bxaaples 

DCL>START/PRINTER  LPO 

MCR>QUE  LPO:/STA 

This  example  starts  print  processor  LPO:.  Printing  continues 
from  the  point  at  which  it  was  stopped. 

DCr.>START/PRINTER  LP0/FLAG:2 

MCR>QUE  LP0:/STA/FL:2 

This  example  starts  print  processor  LPO:.  The  processor  will  put 
two  flag  pages  at  the  head  of  the  job  and  at  the  head  of  each 
file  if  the  user  specifies  flag  pages  in  a  PRINT  command. 

dcl>start/bat<:h_processor  bapo 
mcr>que  bapo:/sta 

This  example  starts  batch  processor  BAPO.  Batch  processing 
continues  from  the  point  at  which  it  was  stopped. 

DCL>START/BATCH  BAPO/CONTINUE 
NCR>0(JE  BAPO:/STA 
The  two  examples  are  equivalent. 
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DCL>START/r'R  INTER  LPl /RESTART 

MCR>OUE  I.Pl  !/STA!RES 

This  exAfflple  staits  print  processor  LPl:.   The  job  Active  at   the 
time  the  processor  was  stopped  Is  restarted. 


Notes 


You  should  chouse  with   care   between   che   /RESTART   (:RES)  and 

/CONTINUE   (MCR  default)  operations.   A  restart  may  conflict  with 

the  desires  of  users  with  print  or  batch  jobs  active  at  the  time 
a  processor  is  stopped. 

Users  can  specify  /NORESTART  (/-RES)  in  their  PRINT  or  SUBMIT 
commands.  If  a  print  or  batch  job  with  this  attribute  is  active 
when  the  processor  is  stopped,  and  you  start  the  processor  with 
the  /RESTART  (:RES)  qualifier,  you  will  be  restarting  tha  jobs  at 
the  top  of  the  file  that  was  being  processed  when  the  processor 
was  stopped,  which  the  user  did  not  want  to  happen.  The 
/CONTINUE  (MCR  default)  qualifier  will  continue  such  jobs  as  the 
user  expected. 

If  you  are  restarting  a  processor  to  handle  special  forms,  you 
will  probably  want  to  set  the  /FLAGS  (:FL)  attribute  to  0  to 
avoid  having  a  banner  page  printed  on  your  special  for:ns. 
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THE   SHUTUP   PROGRAM 


SHUTUP   is   the   system   program      that      enables     orderly     fjhutdown      of     an 
RSX-llM/M-PLUS        system.  SHUTUP        sends      warning      messages,      aborts 

nonpr ivileged    tasks,   and   dismounts  devices  on   the   system. 


8.1      PREREQUISITES    TO   RUNNING   SHUTUP 

To    shut   down   a   system      using      SHUTUP,      the      following      tasks     must     be 
installed : 

o  INDIRECT,    the   MCR    Indirect   Command    Processor. 

e  ACS,    if  dynamic  checkpoint   space    is   established. 

•  BYE,    if  multiuser    protection   support    is    included, 
e  DM0,    if   there   are   any  mounted   devices. 

•  ELI,    if   error   logging    is   active. 

•  In  an  R8X-11H-PLU8  systmi  that  includaa     tiaaourca     Accounting « 
ACC  aust  ba   inatallad. 

If    LB: [1, 21SHUTUP.CMD   is   present,   you  may  want    it   to    install   ACS,    BYE, 
DM0,    ELI,    and   ACC.      See   Section   8.5. 


8.2      INVOKING   SHUTUP 

Invoke   SHUTUP   from   a   privileged    terminal    as   follows: 

>RUN    SSHUTUP^T' 

On      RSX-llM     systens,      SHUTUP     displays     the      following     message     whan 
invoked : 

RSX-llM    SHUT   DOWN   PROGRAM 

On  RSX-11M-PLU8  aystana,   SHUTUP  diaplaya  tha     following     aaaaaga     whan 
invoked : 

RSX-llM-PLUS   SHUT  DOWN   PROGRAM 
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8.3   SHUTUP  INPUT 

SHUTUP  prompts  for  the  number  of  minutes  to  wait  before  the  system  is 
to  be  shut  down,  between  warning  messages,  and  before  disabling 
logins.  If  you  specify  less  than  four  minutes  to  wait  before 
shutdown,  SHUTUP  does  not  ask  the  last  ttra  questions.  Instead,  SHUTUP 
sets  the  interval  between  messages  to  one  minute  and  disables  logins 
immediately. 

The  minutes  between  messages  must  be  greater  than  zero  and  less  than 
the  minutes  before  shutdown  minus  three.  If  you  specify  either  value 
incorrectly,  SHUTUP  rejects  your  answer  and  reprompts. 

The  following  is  an  example  of  SHUTUP  prompts  and  user  input: 

Enter  minutes  to  wait  before  shut  dovm:  1517^ 

Enter  minutes  between  messages:  "^  »(' 

Enter  minutes  to  wait  before  disabling  logins:  SfT* 

After  receiving  your  input,  SHUTUP  asks  for  confirmation  as  follows: 

OK  to  shutdown?   [Y/N] : 

SHUTUP  terminates  without  taking  any  action  if  your  response  to  the 
question  is  N.  If  your  response  is  Y,  SHUTUP  sends  warning  messages 
to  terminals.   Section  8.4  explains  the  messages. 


8  .  4   SHUTUP  OUTPUT 

SHUTUP  sends  warning  messages  to  terminals.  If  the  system  does  not 
support  multiuser  protection,  SHUTUP  sends  warning  messages  to  all 
terminals.  If  the  system  does  supF>ort  multiuser  protection,  SHUTUP 
sends  warning  messages  only  to  logged-in  terminals.  On  multiuser 
systems,  a  terminal  set  to  NOBROADCAST  receives  the  warning  messages 
only  during  the  last  five  minutes  before  shutdown. 

SHUTUP  sends  the  following  warning  messages: 

Please  finish  up,  15  minutes  before  shutdown  --  KERMIT 

Three  minutes  later,  SHUTUP  sends  another  message  as  a  result  of  the 
example  shown  in  Section  8.3.: 

Please  finish  up,  12  minutes  before  shutdown  —  KERMIT 

The  messages  include  a  six-character  name  that  is  a  DECnet  node  name 
(if  DECnet  is  active)  or  the  system  name  that  was  selected  in  SYSGEN 
(if  DECnet  is  not  active).  In  the  previous  messages,  KERMIT  is  the 
six-character  name. 

SHUTUP  continues  to  issue  the  warning  messages  at  the  interval 
specified.  When  three  minutes  remain  before  system  shutdown,  SHUTUP 
changes  the  interval  between  messages  to  one  minute. 
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If  the  systam  supports  multiuser  protection  and  the  specified  delay 
before  disabling  logins  has  expired  (measured  from  the  time  SHUTUP  is 
started) .  SHUTUP  displays  the  following  message  on  the  invoking 
terminal : 

All    further   logins  are  disabled 

After  SHUTUP  logs  off  all  terminals,  aborts  all  nonpr Ivi leged  tasks, 
and  dismounts  all  devices,  it  displays  the  following  message  on  the 
invoking    terminal: 

SHUTUP  operation   complete 

SHUTUP  then  halts   the    processor. 

At  this  point,  you  can  either  boot  another  system  or  resume  operation 
of  the  current  system  by  pressing  the  Continue  switch  on  the  CPU 
console.  After  you  press  the  CONT  switch  (continue),  logins  are 
enabled    and    the    following   message   appears  on   the    invoking    terminal: 

Logins  are   now  enabled 

To  continue  operation  of  the  current  system,  you  must  mount  the 
devices   and    follow  normal    system   start-up  procedures. 


8.5      THE    SHUTUP. CHD   PILE 

The  indirect  command  file  LB: fl , 2] SHUTUP.CMD  is  for  user-specific 
functions.  SHUTUP  submits  the  file,  if  present,  to  the  Indirect 
Command  Processor  for  execution.  The  SHUTUP  task-build  file  specifies 
the  amount  of  time  (the  timeout  interval)  that  SHUTUP.CMD  has  to 
execute.  The  default  timeout  interval  is  120  seconds  or  170(8).  It 
is  f>ossible  to  change  the  timeout  interval  for  SHUTUP.CMD  in  the 
task-build    file. 

On  unmapped  RSX-llM  systems,  the  task  build  fil*  is  [l,20]SHUBLD.CflD. 
On   mapped    RSX-llM   systems,    the    fil*    is    (1,24 1SHUBL0.CMD. 

Fbr    R8X-11N-PLUS  systMIS,   ths   task-build    fil*   Is   (1, 2418HUBLD.CMD. 

If  the  timeout  interval  expires  and  SHUTUP.CMD  is  not  finished,  SHUTUP 
asks    if   you  want   to   wait    for    SHUTUP.CMD  to    finish.      For   example: 

Command    (AT.)    Timeout   -   Continue   waiting?    [Y/Nl : 

If    you  enter   N,    SHU1UP  continues   without   waiting   any   longer.  If      you 

enter      Y,      SHUTUP     waits      an      additional    30   seconds.      SHUTUP  continues 

without  waiting  any  longer  if  SHUTUP.CMD  has  not  finished  at  the  end 
of   the    30   seconds. 

You  may  want  SHUTUP.CMD  to  install  ACS,  BYE,  DM0,  ELI,  and  ACC  (these 
tasks  must  be  installed  to  enable  SHUTUP  to  execute  properly).  If 
DECnet  is  installed  in  your  system,  you  may  use  SHUTUP.CMD  to  shut 
down   the   network. 
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Ttt*   following    la   an  example  of  a    SHUTUP.CMD  fllei 

;7HIS    SHUTUP.CMD    FILE    INSTALLS    ELI 
;AND   ACS    IF    THEY    ARE    NOT    INSTALLED, 
J AND   ALSO   ACTIVATES    A    COMMAND    FILE    TO 
;SHUT   DOWN   THE   NETWORK    IF   THE    NETWORK 
;IS    ACTIVb. 

; 

.ENABLE   SUBSTITUTION 

.IPNINS    ...ELI    INS    SELI 
.IFNINS    ...ACS    INS    SACS 

.IFNACT  NETACP    .GOTO    2C 
PLB: [1,2]NETST0P 

.20i 


8.6      R8X-11M   SYSTEM  SHUTDOWN 

Th«  following  ■•ctions  describe  the  shut-down  procedure  for  RSX-llM 
■ysteMS.  An  annotated  exanple  of  a  system  shutdown  supplenents  the 
description. 


8.«.1     RSX-llM  Systea  Shutdown  Procedure 

When  the  delay  before  system  shutdown     expires,     SHUTUP     performs     the 
following    functions: 

1.  Logs  off  logged-in  terminals     (multiuser     protection     systems 
only)  . 

2.  Stops   the  Console   Logger    (if  active). 

3.  Redirects  the  console  terminal   to   the  TI:      of  SHUTUP. 

4.  If  the   indirect  command   file   LB: [1,2] SHUTUP.CMD     is     present, 
submits   it  to   the   Indirect  Command   Processor   for  execution. 

5.  Stops   the   Queue   Manager    (if  active). 

K.      Stops   the   Error   Log   Task    (ERRLOG)    (if  active) . 

7.  Deallocates  checkpoint  space  and  dismounts  devices. 

8.  Halts  the  processor. 

At   this  point,   you  can  either  boot  another   system  or   resume     operation 
of  the  current  system. 
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:0,n.2     IxaBpl*  of  an  R8X-11N  Syatra  Shutdown 

!^o  following  ia  an  axaapla  of  an  R3X-11M  ayataa  ahutdowti 

>I»UN  ttHUTUP 

I^MX-llH  SHUT  DOWN  PKOQRAH 

tntar  ainutat  to  uaii  bafora  ahutdownS  10  SD 

;intar  atnuiat  batwaan  avaiaaatt  3  IT) 

Entar  alnutaa  to  wait  bafor*  ditablina  loalnat  S  S!) 

OK  to  ahutdownT  CY/Nlt  Y  IfTi 

'17-FEl-il  lAtSS  Plaaic  finish  u^t  10  ainutvs  bafora  shutdown  —  QUASAR 

17-FEB-81  :4t3S  Plaata  finish  up»  7  ainutas  bafora  shutdown  —  QUASAR 

.All  furihar  loalns  ara  disablad 

17-rEt-tl  lAt40  Plaasa  finish  u»>  5  ainutas  bafors  shutdown  --  QUASAR 

17-FES-ei  1AU2  Plaasa  finish  up*  3  ainutas  bafor*  shutdown  --  QUASAR 

17-FE1-61  1AM3  Plaasa  finish  u^t  2  ainutas  bafora  shutdown  --  QUASAR 

t7-FES-81  lAt44  Plaasa  finish  uPt  1  alnuta   bafors  shutdown  --  QUASAR 

17-FES-81  Ut4S  Swstaa  is  now  shuttina  down  --  QUASAR 

«ET  /COLOO-OFF  0 

> 

tLBtCl>23SHUTUP  #  . 

>INS  «ELI  ^ 

>IN8  fACS 

>t  <EOF> 

> 

QUE  /8T0IQH0  # 

> 

ELI  /NOLOO  0 
t«i4A:01  ERRLOO  —  Error  Loddina  stopr'ad 
> 

ACS  DBOt/BLKS-O.  # 
ACS  —  Chaek^oint  fila  now  inactiva 
DHO  OBOi/DEV  % 
> 
DNO  --  Swataa  disk  baina  disaountad 

—  SYSTEN  disaountad  froa  DBO:   »««  Final  disaount  initiatad  ««» 
Ut47tlO   *»»  DBOt  —  Disaount  coa^lwta 
> 

JMO  D80:/DEV  O 

ano  —  Uarnina  -  Tasks  installad  froa  DSOt 

MIO  —  SYSTEM  disaountad  froa  DSOt   ««»  Final  disaount  initiatad  «*« 
i«t47t20   «*»  DSOt  —  Disaount  coarlata 
> 
•MUTUP  oparation  coaplata  A 


V 
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TO  shut  dotm  the  aystMi  In  thia  •x«apl«,  SHUTUPi 

0   Stops  th«  Consol*  Loqqmr . 

0   Invokaa  tha  indiract  coaaand  flla  Lit [1,2] 8HUTUP.CMD. 

SHUTUP.CMD   install  a   ELI   and   ACS.    Tha   9<B0P>    aaaaaq* 
indlcataa  tha  and  of  tha  coamand  flla  SHUTUP.CMD. 

9  Stops  tha  Quaua  Nanagar. 

0  Runs  tha  task  BLI  to  tarainata  tha  Error  Log  Task  (BRRLOG) . 

0  Daallocataa  chackpolnt  fllas  on  DBOi. 

0  Diaaounwa  tha  dlaka  on  DBOi   and  DSOt. 

0  Displays  a  mansaga  whan  SHUTUP  has  Cinishad  axacuting. 

8.7   MX-1  IN-PLUS  SYSTEM  SHUTDOWN 

Tha  following  sactions  dascrlba  tha  shut-down  procadura  for 
RSX-llM-PLUS  systoas.  An  annotatad  axaapla  of  «  systaa  shutdown 
supplaaants  tha  dascription. 

8.7.1  R8X-11N-PLU8  Syataa  Shutdown  Procadura 

Whan  tha  dalay  bafora  systaa  shutdown  axpiras,  SHUTUP  parforas  tha 
following  functions! 

1.  Stops  tha  Consols  Loggar  (if  activa) . 

2.  Radiracts  tha  consola  tarainal  to  tha  TI:  of  SHUTUP. 

3.  If  tha  indiract  coaaand  fila  LB i( 1,2] SHUTUP. CMC  ia  prasant, 
subaits  it  to  tha  Indiract  Coaaand  Procassor  for  axaoution. 

4.  Logs  off  lo<jgad-in  *:a^ainals   (aultiusar  protaction  systaas 
only) . 

5.  Stops  tha  Quaua  Managar  (if  activa). 

6.  If  Rasourca  Accounting  is  activa »  s«:ops  Rasourca  Accounting. 

7.  Stops  tha  Error  Log  Task  (BRRLOG)  (if  activa). 

8.  Checkpoints  all  raad/wrlta  conaons. 

9.  Daallocatas  chackpolnt  spaca  and  disaounts  davicas. 

10.   Halts  tha  procassor. 

At  this  point,  you  can  aithar  boot  anothar  systaa  or  rasuvt  oparation 
of  tha  currant  systaa. 
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8.7.2  Bxampl*  of  an  RSX-M-PLUS  Systaa  Shutdown 

Th«  following  is  an  •xanpio  of  an  RSX-lir*-PLU')  system  shutdotimi 

>KUN  fSNUTUP 

R8X-11H-PLU6  SHUT  DOWN  PROORAH 

Enter  Minutss  to  wait  bafora  shutdown:  10  11!) 
Entar  ainutas  batwaan  aassaSast  5  ID 
Entar  ainutas  to  wait  bafora  disabling  losint:  2  SD 
OK  to  •hutdown'*  rY/Nl!  Y  SD 

OS-NAR-tl  16:34  Plaasa  finish  u^i  10  ainutas  bafor*  shutdown  --  CASTOR 

All  furthar  logins  ara  disabled 

OS-HAR-Bl  l«t39  Plaasa  finish  upt  5  »inutas  before  shutdown  --  CASTOR 

OS-NAR-81  1A:41  Please  finish  up t  3  ainutas  before  shutdown  —  CASTOR 

05-HAR-ei  1«:42  Please  finish  u^t  2  ainutas  b«rfor«  shutdown  --  CASTOR 

OS-HAR-81  16:43  Please  finish  up»  1  ainuta  baTcre  shutdown  --  CASTOR 

OS-HAR-81  16:44  Swstea  is  now  shuttintf  down  --  CASTOR 

•Li:Cl»2]SNUTUP  0 

>IN8  SELI 

>IN8  SACS 

>f  <EOF> 

> 

QUE  /8T0:QH6  # 

> 

STOP/ACCOUNTING  SHUTUP  # 

> 

ELI  /HOLOG  O 
16:30:20:  ERRLOO  --  Error  Losain*  stopped 
> 

ACS  DB7:/BLKS-0.  # 
ACS  —  Checkpoint  file  now  inactive 
DHO  D87:/DEV/L0CK-V  0 
> 

OHO  —  Swstea  disk  being  disaounted 

DHO  --  8Y8TEH  disaounted  froa  DB7:  \^t*   Final  Bisaount  Initiated  ««* 
16:47:19   «*«  DB7:  --  Disaount  coaplata 
> 
SHUTUP  operation  coaplate  0 

To  shut  do%m  the  system  in  this  example,  SHUTUP: 

0   Invokes  the  indirect  command  file  LB: [1 ,2] SHUTUP.CMD. 

SHUTUP. CMO   installs   ELI   and   ACS.    The   9<E0P>   message 
indicates  the  end  of  the  command  file  SHUTUP.CMD. 
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Stops  th«  Ou«u«  Ptanaqcr. 

Stop*  Resource  Account inq* 

Runs  ths  task  BLI  to  tsrninats  tha  Error  Log  Task  (BRRLOG) . 

Daallocatas  uhackpolnt  fllas  on  DB7:. 

Disaounts  the  disk  on  DB7i. 

Ttie  Virtual  option,  /LOCK-V,  is  privileged.  When  you  specify 
the  Virtual  option,  the  DISMOUNT  command  does  not  clear 
volume  as  valid  and  does  not  spin  doim  the  disk.  (Refer  to 
the  R8X-11M/M-PLUS  MCR  Operations  Manual  for  additional 
Inforaationn 

Displays  a  message  when  SHUTUP  has  finished  executing. 
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CHAPTER  9 
USER  ENVIRONMENT  TEST  PACKAGE  (UETP) 


The  User  Environment  Test  Package  (UETP)  verifies  the  Integrity  and 
operation  of  a  newly  generated  RSX-1 IM/M-PLUS  system.  The  program 
consists  of  several  Indirect  command  files  that  verify  the  presence 
and  operation  of  devices,  test  the  basic  Executive  features,  and 
verify  the  presence  of  system  utilities. 

UETP  does  not  replace  the  hardware  diagnostic  tests  that  DIGITAL  Field 
Service  performs  on  your  devices  nor  does  it  substitute  for  software 
testing  during  software  development.  UETP  only  verifies  that  your 
system  generation  has  produced  a  working  operating  system  with  the 
configuration  you  Intended. 


9.1   STRUCTURE  OF  THE  UETP 

UETP  consists  of  seven  modules:  five  test  modules,  an  Initialization 
module,  and  a  cleanup  module.  During  Initialization,  the  program 
allows  you  to: 

•  Select  the  number  of  times  you  wish  to  run  UETP 

•  Select  which  of  the  five  tests  you  wish  to  run 

•  Include  or  omit  extended  comments  at  the  start  of  each  test 

•  Exclude  devices  from  testing 

UETP  time-stamps  the  start  and  end  of  the  output  for  each  test  module. 
If  a  module  cannot  run  because  of  any  of  the  restrictions  discussed  in 
Sections  9.1.1  and  9.1.2,  UETP  outputs  an  error  message. 

The  five  test  modules  are: 

•  Load  Test 

•  I/O  Exerciser  Test 

•  Utilities  Test 

•  MCR  Command  Test 

•  Interactive  Utilities  Test 

Each  of  these  test  modules  is  discussed  briefly  in  the  following 
sections. 
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9.1.1   Th«  Load  Test 

The  Loafi  Test  exoiclses  the  multitasking  and  multiprogramming 
capabilities  of  your  system.   The  Load  Test: 

•  Determines   whether   the   memory   encompassed   by   the   system 
partition,  GEN,  is  available  to  the  system 

•  Uses  the  Send  and  Receive  Executive  Directives 

•  Tests  swapping  and  round-robin  scheduling  if  they  are   present 
in  your  system 

On  RSX-llM  systems,  your  system  must  support  all  of  the  following 
features  to  enable  the  Load  Test  to  run: 

•  ASTs 

•  Memory  mapping 

•  Send/Receive  directives 

•  Alter   Priority  directive 

•  Get    Partition    Parameters  directive 

•  Dynamic   checkpointing 

UETP  determines  the  presence  of  these  features.  It  outputs  a  message 
to  your  terminal  if  the  Load  Test  cannot  be  run  because  one  or  more  of 
these  features  ij  not  present. 


9.1.2   The  I/O  Exerciser  Test 

This  test  riir.".  the  I/O  Exerciser  (lOX),  which  is  a  software  tool  for 
detecting  and  diacjnosing  I/O  problems  on  the  disk  and  tape  units  in 
your  system's  hardware  configuration.  lOX  performs  I/O  testing  on 
disks,  magnetic  tapes,  cassettes,  and  DECtapes.  lOX  exercises  disk 
and  tape  units  that  have  recording  media  in  place  and  are  not 
allocated  to  other  users.   If  units  are  not  mounted,  lOX  mounts  them. 

lOX  destroys  the  contents  of  tapes  and  nonf 1 le-structured  disks  during 
testing.  lOX  exercises  Files-11  disks  without  destroying  their 
contents,  because  lOX  creates  and  deletes  its  own  files  during 
testing. 

For  RSX-llM  systems,  the  I/O  Exerciser  can  only  test  systems  that 
support  ASTs. 


9.1.3   The  Utilities  Test 

This  test  invokes  some  of  the  RSX-llM/M-PLUS  utilities:  CMP,  FLX, 
DMP,  CREF,  PMD,  PRT,  USC,  PAT,  SLP,  and  LBR.  It  verifies  their 
presence  and  performs  a  simple  test  of  their  functions. 
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9.1.4   Th«  MCR  Coimand  Test 

This  module  tests  some  of  the  MCR   disk '-access   commands:   ALL,   DEA, 
MOU,  DM0,  INI,  UFD,  and  VFY  and  the  DAD  utility. 


9.1.5  The  Interactive  Otilities  Test 

This  test  invokes  EDI,  EOT,  ZAP,  anu  ACNT.  You  must  be  present  at  the 
terminal  from  which  the  UGTP  is  running  to  exit  from  the  interactive 
utilities  that  this  test  module  invokes. 


9.2   OPERATING  ENVIRONMENT 

You  run  UETP  following  system  generation.  To  ensure  the  integrity  of 
the  testing,  UETP  should  have  unlimited  access  to  all  system  features 
and  devices.  You  should  therefore  run  UETP  on  a  stand-alone  basis  for 
two  reasons:  (1)  users  may  change  the  state  of  the  system,  thereby 
invalidating  or  modifying  the  results  of  UETP  and  (2)  UETP  puts  a 
heavy  load  on  the  system,  which  may  interfere  with  other  work  on  the 
system. 

To  run  the  UETP,  you  need  only  one  terminal.  It  must  be  a  privileged 
terminal.  It  is  best  to  run  the  program  from  a  hard-copy  terminal  so 
that  you  have  a  record  of  any  error  messages  generated  during  the 
execution  of  UETP.  If  you  have  a  second  terminal  that  is  a  CRT 
terminal,  you  can  use  it  to  run  the  Memory  Display  of  RMD  which 
monitors  how  the  system  memory  is  being  allocated  while  UETP  is 
executing.   This  is  particularly  useful  during  the  Load  Test. 

For  RSX-llM  systems,  the  command  files  that  comprise  UETP  are  located 
in  UFD (2, 300]  on  one  of  the  disks  in  your  system  as  follows: 

Diak  Typ«       Vol«M«  LalMl 

Big  Disks 

RP04/05/06        RSXM32 
RM02/03  RSXM32 

RK06/07  CLISRC 

RL01/RL02  HLPDCL 

RK05  HLPSYS 

For  RSX-11N-PL(JS  systems,  the  command  files  that  comprise  UETP  are 
located  in  UFD (2, 300]  on  the  disk  lat>eled  RSXIIMPBLIO. 

For  RSX-lIM  systems  on  RL01/RL02  and  RK05  kits,  you  must  hav* 
completed  SYSGEN  Phase  III  to  build  the  nonprivileged  tasks  that  you 
want  UETP  to  test.  These  tasks  are  tested  in  the  Utilities  Test,  the 
MCR  Command  Test,  and  the  Interactive  Utilities  Test  (see  Sections 
9.1.3  through  9.1.5  for  a  list  of  these  tasks).  You  must  have  also 
built  lOX  if  you  want  to  run  the  I/O  Exerciser  Test. 

To  run  the  Utilities  Test,  you  must  have  a  scratch  disk  or  DECtape. 
To  run  the  MCR  Command  Test,  you  must  have  a  scratch  disk.  To  run  the 
DSC  in  the  MCR  Command  Test  module,  you  must  have  a  floppy  disk  or 
DECtape. 

The  utilities  BAD,  TKB,  and  MAC  must  be  present  on  the  system  disk  or 
already  installed  for  UETP  to  run. 
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9.3   OPIRATIMG  PROCIDORBS 

B«for«  running  th«  UETP,  craate  the  necessary  operating  environment  as 
described  in  Section  9.2.  After  you  log  in  on  the  privileged  terminal 
from  which  you  wish  to  run  UETP  do  the  following: 

1.  Place  scratch  media  on  all  DECtape,  cassette,  floppy,  and 
magnetic  tape  drives  that  you  want  to  test.  Place 
initialized  Files-11  disk  packs  on  all  disk  irives  that  you 
want  to  test.  The  I/O  Exerciser  Test  destroys  data  on  the 
nonf ile-structured  disks  and  tapes;  therefore  you  must  use 
scratch  media.  lOX  does  not  destroy  data  on  Files-ll  hard 
disks;   therefore  they  need  not  be  scratch  disks. 

2.  Assign  your  system  disk  to  LB:   by  typing 

>ASN  ddnn:-LB: 
ddnnt 

Logical  devicf  name  of  your  system  disk. 

3.  For  RSX-llH  systems  that  do  not  have  a  big  disk,  the  systeni 
disk  and  the  disk  containing  the  UETP  files  are  not  the  same. 
If  your  systen  disk  has  enough  free  blocks  to  accomnodate  all 
the  UETP  coonand  files  plus  300  to  400  additional  blocks  for 
files  that  UETP  creates,  then  you  may  want  to  copy  the  UETP 
files  to  your  system  disk. 

Assign  the  disk  that  contains  the  UBTP  files  to  SYt   by 
typing 

>ASN  ddnn:-SY: 

ddnnt 

Logical  device  nan*  of  the  disk  that  contains  the  UBTP 
files. 

4.  Allocate  checkpoint  space  for  the  system.  You  need  two 
blocks  for  each  IK  bytes  of  memory  on  your  system. 

>ACS  SY:/BLKS-512. 

5.  Execute   the   UETP.CMD  command    file  by   typing 

>e(2, 300] UETP 


9.4   ERROR  REPORTING 

Tasks  that  detect  errors  may  output  error  messages  to  your  terminal. 
lOX  does  its  own  error  reporting.  Tasks  that  run  during  the  MCR 
Command  Test,  the  Utilities  Test,  and  the  Interactive  Utilities  Test 
output  their  own  error  messages. 
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The  DEFINE  task,  which  qets  the  system  conf Iqurat Ion  information  for 
UETk,  and  some  of  the  tasks  that  comprise  the  Load  Test  generate  error 
messages.  For  the  most  part,  these  tasks  use  the  following  format  for 
error  messages: 

taskname  KRROR   nn  ccc 

taskname 

Nan\e  of  the  task  that  caused  the  error. 


nn 


ccc 


Error  number  specific  to  that   task   (defined   In   the   following 
sections  for  each  task). 


Low  byte  In  octal  of  the  SOSW  for  Executive  Directive  errors  or 
F.ERR(Rn)  for  PCS  errors.  (For  more  information  on  the  $DSW,  see 
the  RSX-l IM/M-PLUS  Executive  Reference  Manual .  For  more 
information  on  F.ERR(RO),  see  lAS/RSX-'.l  I/O  Operations  Reference 
Manual . ) 

The  error  numbers  for  each  task  identify  which  kind  of  macro 
instruction  caused  the  error.  The.ie  are  either  FCS  macros  or 
Executive  Directive  macros. 


9.4.1   The  System  Configuration  Module  (DEFINE. TSK) 

The  error  messages  for  the  system   configuration   module,   DEFINE. TSK, 
are  as  follows: 

Error  No.    Macro  Explanation 

Open  to  create  CONFirs.CMO  file  fallen. 
Open  file  TAILOR. OAT  for  read  (FDB=FDTAIL)  failed. 
Read  of  file  TAILOR. OAT  failed  ( FDB=FDTAIL) . 
Wait  for  file  TAILOR. OAT  (FDB=FDTAIL)  failed. 
Close  of  file  TAILOR. OAT  (FDB=FDTAIL)  failed. 
Close  failed  for  CONFIG.CMD  file. 
Output  to  CONFIG.CMD  file  failed. 
Exit  failed. 


9. A. 2      The  Monitoring  Task  for  QT  Load  Task  (LOGGERTSK) 

The   error   messages   for   the   mnpltoring   task   for   QT   Load   Task, 
LOGGER. TSK,  are  as  follows: 

Error  No.   Macro  Explanation 

1  OPENSW     Failure  of  open  for  write  to  RUNLOG.DAT  file. 

2  0PEN5W     Failure  of  open  for  write  to  ERRLOG.DAT  file. 


I 

0PEN5W 

2 

OPENSR 

3 

READS 

4 

WAITS 

5 

CLOSES 

*i 

CLOSES 

9 

PUTS 

19 

EXITSS 
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or  RUNLOr,  .DAT  file, 

file. 

or  RUNLla.DAT  file. 

or  ERRLfJG.DAT  file. 


PUTS  Failure  of  write  to  ERRLOG.DAT 

PUT?  Failure  of  write  to  ERRLOG.DAT 

PUT;  1*81  lure  of  write  to  ERRLOC.nAT 

PUToR  (allure  of  write  to  RUNLOG.DAT 

WSIGSS  Walt  for  Significant  Event  directive  fillure. 

RCVDSC  Receive  Data  directive  failure. 

ALUNSS  Assign  LUN  directive  failure. 

WTSESC  Wait  for  Significant  Event  directive  failure. 

SETFSS  Set  Event  "lag  directive  error. 

PDATSS  Send  Data  Directive  failure. 

CLOSES  Close  failure  of  RUNLOG.DAT  or  RRRLOG.DAT  file. 

GTIMSC  Get  Time  directive  failure. 

CLEFSS  Clear  Event  Flag  directive  failure. 


9.4.3   The  Startup  QT  Load  Task  (QTRUN.TSK) 

The  error  messages   or  the  Startup  QT  Load   Task,   QTRUN.TSK,   are   as 
t  il lows : 


Error  No. 

Macro 

OPENSW 

OPENSR 

READS 

WAITS 

Ct.ORRS 

CLOSES 

GPRTSC 

PUTS 

RSUMSS 

10 

RQSTSS 

13 

WSIGSS 

14 

RSUMSS 

15 

RQSTSS 

16 

SDATSS 

17 


SDATSS 


18 

RSUMSS 

19 

EXITSS 

20 

GTIMSC 

21 

ALTPSC 

22 


MRKTSC 


Explanation 

Open  failure  on  DVLREM.CMD  or 
Open  failure  on  TAILOR.DAT  fl 
Read  failure  on  TAILOR.DAT  fl 
Walt  failure  on  TAILOR.DAT  fi 
Close  failure  on  TAILOR.DAT  f 
Close  failure  on  DVLSET.CMD  f 
Get  Partition  Parameters  Exec 
Write  failure  for  .CMD  files 
Resume  Executive  directive  fa 
Request  Executive  directive  f 
Wait  for  Slfinificant  Event  Ex 
Resume  Executive  directive  fa 
Request  Executive  directive  f 
Send  Data  Executive  directive 
(failure  of  Send  Data  to  QT  t 
Send  Data  Executive  directive 
(failure  of  Send  Data  to  LOGG 
Resume  Executive  directive  fa 
Exit  Executive  directive  fail 
Get  Time  Executive  directive 
Alter  Priority  Executive  dire 
(alteration  of  Indirect  comma 
Mark  Time  Executive  directive 


DVLSET.CMD  file. 
le. 
le. 
le. 
lie. 

lie  or  DVLREM.CMD  file, 
utlve  directive  failure, 
created  by  QTRUN. 
ilure  for  DUMMY  task, 
allure  for  LOGGER  task, 
ecutlve  directive  failure, 
Ilure . 
allure. 

failure 
ask)  . 

failure 
ER  task) . 
Ilure. 
ure . 

failure . 
ct  Ive  fa  ilure 
nd  file  priority  failed). 

fa  i lure. 


9.4.4   The  NULl  Form  of  the  QT  Load  Task  (NULl.TSK) 

The  error  reporting  f->rmat  for  NULl.TSK  differs  from  the  general  error 
reporting  format.  When  a  directive  error  occurs,  the  QT  Load  Task 
pr  ints 

TASK  QTnn  ABORTING 

where  "nn"  Is  the  task  number  that  identifies  the  task  that  caused  the 
error . 
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The  •rror  number  Is  then  displayed  as 

ERROR   XX 

where  "xx"  corresponds  to  one  of  the  error  conditions  described  In  the 
following  table. 

After  displaying  the  error  number,  the  task  displays  the  SDSW. 


Error  No. 

0 
I 
3 

4 
S 

6 
7 


R 
12 


Macro 

SPNDSS 
RCVDSC 
ALUNSS 

MRKTSC 
EXTFSS 
DSC  PS S 
SDATSS 


ASTXSS 
CLEFSC 


Explanation 

Suspend  dirt^ctive  issued  by  QT  Load  Task  failed. 
Receive  Data  directive  failed  (receive  from  CONFIG), 
Assign  Logical  Unit  Number  directive  failure  to  use 

TT  number  received  from  CONFIG. TSK. 
Mark  time  directive  failure. 
Exit  directive  failure. 

Disable  Checkpointing  directive  failure. 
Send  Data  directive  failure  (send  to  LOGGER  before 
exiting).  Insufficient  dynamic  muii'ory  can  cause 

this  error. 
AST  Service  Exit  directive  failure. 
Clear  Event  Flag  directive  failure. 


9.5   SAMPLE  UETP  CONSOLE  DIALOG 

Tho  console  dialog  In  Example  9-1  is  from  a   session   of   running   the 
UETP  on  an  RSX-llM  system. 

On  RSX-llM-PLUS  systems,  mount  aK  scratch  disks  using   the   /FOREIGN 
switch  for  the  MOUNT  command.  Mount  all  tapes. 

Example  9-1   Sample  UETP  Console  Dialog  Jor  a  System  Using  RLOls 

>ASN  dlj-lb: 

>ASN  DLlt'SV: 
>ACS  SY;/BLKS«512. 

> 

>BC?)300]UETP 

>ID!SK  >  DL:  UIC  -  C2r300D 

>SET  /UIC-C2.3003 

>t**t4*    THINKING  «***t 

>i  NEEDED  UTILITIES  UU.L  BE  INSTALLED  NOU. 

>INS  LB:$rtAC/CKP=YES 

>INS  lb:*tkb/ckp=yes 
>INS  lb:*cmp/ckp=yes 

>INS  LBt$LBR/CKP=YES 

>INS  LBJ$PIP/CKP  =  YES  ■'      '  . 

>iNS  lb:»edi/ckp=yes 

>( 

>i  *  * 

>i  *    RSX-llM  V4,0  UETP  PROCEDURE  STARTED    AT  13:57:34  ON  20-JUL-81   * 

>i  *  « 

>i 

>*    ENTER  NUMBER  OF  PASSES  FOR  UETP  CO  R:1-100  D:1D:  1 

>» 

>«  RUN  LOAD  TEST?  CY/N3J  Y 

>i 

(continued  on  next  page) 
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Example  9-1  (Cont.)   Sample  UETP  Console  Dialog  for  a  System  Using  RLOla 

>«  RUN  10  EXERCISER?  CY/N]:  Y 

>» 

>»  RUN  UTILITIES  TE8TT  CY/NDi  Y 

>t    RUN  NCR  COHNAND  TEST?  CY/N31  Y 

>» 

>«  RUM  INTERACTIVE  UTILITIES  TEST?  CY/NDt  Y 

>l 

>«  EXTENDED  COMHENTS  DESIRED?  CY/NDt  Y 

>» 

>«  IF  PRESENT*  ACTIVATE  ERROR  LOOSER?  CY/N]t  Y 

>» 

>l 

>»  DO  YOU  UISH  TO  RUN  RHDEMO?  CY/N3J  Y 

>l 

>*  ENTER  TERMINAL  NUMBER  FOR  RMDEMO  C03:  2 

>» 

>INS  LB:»RMD/TASK-T2RMD 

>REA  T2RMD  1  TT2: 

>REA  T2RMD  2  TT2J 

>RUN  T2RMD 

>ELI  /LOO 

ERRLOG  —  Error  Lodging  initialized 

>» 

>«  PAUSE  INITIALIZE  DISKS  OR  MOUNT  TAPES?  CY/NDt  Y 

>» 

...AT.   --   Fausinfl.  To  continue  tape  'UNS  ...AT.<ESC>" 

;>ALL  MMOt 

>ALL  DM0 t 

>MOU  DMOt/OVR 

>ALL  DKOt 

>MOU  DKOt/OVR 

> 

>UNS  ...AT. 

...AT.  --  Continuing 

> 

>MAC  dUETPASM 

>TKB  8UETPBLD 

>MAC  DEFlNE=LBtCllf 10]RSXMC/PAtl.SYtC2f300DDEFINE 

>TKB  DEFINE/PR/CP=DEFINE.LBtC1.54DRSXllM.STB»Clfl]EXEL IB/LB 

>PIP  NUL1.0BJ>*fNUL2.0BJ»«fNUL3.0BJJ«iLaGGER.0BJJ«.«TRUN.0BJ»»/DE/NM 

>PIP  DUMMY. OBJ»«/DE»DEFINE.OBJf«»*.DAT»«fERRLOG.LSTf*/NM 

>PIP  CRTEST.LSTIl/DE»CRTEST.OBJJl/DEiCRTEST.TSK»l/DE/NM 

>PIP  «.«/PU 

>INS  DEFINE/TASK=DEFINE 

>PIP  TAILOR. DAT=DEVM.SAM/AP 

>RUN  DEFINE  '■ 

>» 

>»  THESE  ARE  THE  DEVICES  INCLUDED  IN  YOUR  SYSTEM 

>f 

>DEV 

IPOt  OFFLINE  UNLOADED 

UDOt  OFFLINE 

XMOt  OFFLINE  LOADED 

XPOt  OFFLINE  LOADED 

XQOt  OFFl  INE  LOADED 

LPOt  OFFLINE  LOADED 


(continued  on  next  page) 
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Example  9-1  (Cont.)   Samplt  Ui  TP  Console  Dialog  for  a  System  Using  RLOls 

DBOt  LOADED  TYPE-RP04 

DKO:  TTO:  -  PRIVATE  MOUNTED  LOArEP  LABEL-TESTA 

DLOJ  '>UBLIC  MOUNTED  LOADED  L ABEL-R3)CM32  TYPE-RLOl 

DLi:  MOUNTED  LOADED  LABEL-HLPDCL  TYPE-RLOl 

DMOI  TTO:  -  PRIVATE  MOUNTED  LOADED  LABEL-TE8TB  TYPE-RK06 

DHU  LOADED  TYPE-RK06 

DYO:  OFFLINE  LOADED  TYPE-RX02 

DYIJ  OFFLINE  LOADED  TYPE-RX02 

MMO:  TTO?  -  PRIVATE  LOADED 

coo:     TTOS 

TTO:  C2>300]  -  LOOOED  ON   LOADED 

TTU  LOADED 

TT2:  LOADED 

TT3:  LOADED 

TT4S  LOADED 

TT5S  LEADED 

TT6:  LOAI'ED 

TT7:  LOADED 

TTIO:  LOADED 

NLO: 

Tio: 

CLO!  TTO: 
LBO:  DLO: 
SYO:     DLOJ 

>l 

>>  IF  YOU  DO  NOT  WISH  TO  TEST  OR  DO  NOT  HAVE  MEDIA  FOR  ANY 

>l  OF  THE  ONLINE  DEVICESr  SPECIFY  THEM  NOW  (ONE  AT  A  TIME) 

>»  TYPE  <CR>  WHEN  FINISHED. 

>» 

>*  SPECIFY  TAPE  OR  DISK  TO  BE  EXCLUDED  tSD5  DB 

>«  SPECIFY  TAPE  OR  DISK  TO  BE  EXCLUDED  CS3:  DM1 

>«  SPECIFY  TAPE  OR  DISK  TO  BE  EXCLUDED  [S3:  «Et 

>» 

>; 

>»       TO  RUN  THE  MCRi  FLXt  AND  DSC  TESTS  AT  LEAST  ONE  SCRATCH  DISK  (OR 

>»       DECTAPE)  MUST  BE  SPECIFIED.   ENTER  SCRATCH  DISK(S)»  AND  TYPE 

>>       <CR>  WHEN  FINISHED. 

>i 

>»  SPECIFY  A  SCRATCH  DISK  CSD:  DK 

>«  THE  CONTENTS  OF  DKO  WILL  BE  LOST  !!  APPROVE  ?  CY/N3:  Y 

>«  SPECIFY  A  SCRATCH  DISK  CS3:  (© 

>l 

>t  *    LOAD  TE3T  STARTED  AT  14:27:24   » 

>> 

>i    FOR  THE  NEXT  FEW  MiNUTES  A  NUMBER  OF  COMPUTE-BOUND  TASKS  WILL  BE 

>»  EXERCISING  THE  MULTI-TASKING  CAPABILITIES  OF  THE  SYSTEM. 

>»  AND.  IF  INCLUDED  IN  THIS  SYSTEM.  THE  ROUND-ROBIN  SCHEDULER. 

>»  THE  SHUFFLER  AND  CHECKPOINTING.   THE  ACTION  OF  THESE  LAST  THREE 

>»  FEATURES  CAN  BE  SEEN  ON  THE  RMDEMO  SCREEN.   IF  THE  SYSTEM  IS 

>l  PERFORMING  PROPERLY.  ALL  OF  THE  "OEN*  PARTITION  IS  USED  AND  THE  "QT" 

>f    TASKS  ARE  SHARING  SYSTEM  RESOURCES  IN  A  MANNER  CONSISTE'  f 

>»  WITH  THE  FEATURES  AVAILABLE.   NOTE  ^HAT  CHECKPOINTING  IS  DISABLED 

>l  FOR  THE  SECOND  HALF  OF  THE  TEST. 

>» 

>»       *««  THIS  TEST  RUNS  FOR  A  MAXIMUM  OF  6  MINUTES  **« 

>i 

>INS  DUMMY/TASK-DUMO0/PRI=40. 

>INS  L0QGER/TASK=L0G00 

>INS  QTKUN  /TASK=QTR00 

(continued  on  next  page) 


9-9 


USER  ENVIRONMENT  TEST  PACKAGE  (UETP) 

Example  9-1  (Cont.)   Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 

>RUN  DUHOO 

.. .^T.  --  DELAYINO 

>t.AT>  --  ContlnulnS 

>RUN  QTROO 

> 

>IN8  NUL2/TA8K-QT0000 

>INS  NUL2/TA3K-QT0100 

>IN8  NUL2/TASK-QT0200 

>IN8  NUL2/TASK='QT0300 

>•       >>>>>>  THE  LOAD  TEST  IS  RUNNING  <«<<< 

>REH  QTOOOO 

>REM  QTOIOO 

>REM  QT0200 

>REH  QT0300 

>REi1  DUHOO 

>REH  LOOOO 

>REH  OTROO 

>l 

>»       «  LOAD  TEST  COMPLETED  AT  1^:34:17   « 

>P 

>l 

>l       *  lOX  TEST  STARTED  AT  M:34:17  * 

>» 

>l  «««»  NOTE  **** 

>» 

>f  TEST  MEDIA  MUST  BE  LOADED  ON  ALL  TAPE  AND  DISK  DRIVES.   USE  SCRATCH  TAPES 

>t    AND  FILES-U  FORMAT  DISKS. 

>l 

>)  ALL  MAGTAPES  BEING  TESTED  ARE  OVER-URITTEN .   THE  DISKS  ARE 

>l  TESTED  WITH  FILE-STRUCTURED  I/O  WITH  NO  NEGATIVE  EFFECT  ON  DATA 

>>  OR  STRUCTURE. 

>» 

>♦  BEFORE  PERFORMING  THE  FILE-STRUCTURED  I/O  TEST.  ALL  UNMOUNTED 

>l  DISKS  ARE  MOUNTED  AUTOMATICALLY. 

>» 

>t    DEVICES  LISTED  AS  'OFFLINE'  ARE  NOT  PHYSICALLY  PRESENT  AND  ARE  NOT 

>)  TESTED.   INDIVIDUAL  MAO  TAPEr  DEC  TAPE  AND  RKOS  UNITS  CAN 

>>  ERRRONEOUSLY  BE  SHOWN  AS  ONLINE  WHEN  THE  CONTROLLER  IS  ONLINE. 

>»  THEY  ARE  TESTED  AND  THE  TEST  FAILS  AFTER  SEVERAL  MINUTES 

>l  OF  ERROR  MESSAGES. 

>i 

>» 

>»  IF  ANY  DRIVERS  ARE  UNLOADED,  THEY  WILL  BE  LOADED  NOW. 

>l 

>|  ««««««««»[« 

>INS  tlOX/TASK-. . .810 
>  i 

>i 

>t       THE  SYSTEM  I/O  EXERCISER  WILL  RUN  FOR  3  MINUTES 

>SIO  9I0XCN 

SIO  --  SuRinsru  of  exerciser  activity   at  20-JUL-81  14:34:10 
TIME  --  Runt  3  min.    Elapsed!  3  mn.    Reiiainirisi !  0  Bun. 
DKOJ  --  3»357.  R/W  reauests  totalina  3»357.  blocks  with  no  errors 
DLO:  --  2f881.  R/W  reauests  totalina  2r881.  blocks  with  no  errors 
DLi:  --  2»930.  R/W  reauests  totaling  2»930.  blocks  with  no  errors 
DMO:  --  5.901.  R/W  reouests  totalina  5.901.  blocks  with  no  errors 
MMOS  --  651.  R/W  reouests  totalina  651.  recuids  with  no  errors 
AST's  executed:  15,720. 
Idle-loop  iterations:  6,798. 

(continued  on  next  page) 
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Example  9-1  (Cont.)   Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 
ACCUMULATED    TOTALSt 


TINE  --  Run!  3  kin*    Ela^tvdS  3  nin.    Renainln^i  0  nin. 

DKO:  --  3>351.  R/U  reauevts  toiallnd  3»3S8.  blocks  with  no  vrort 

OLOS  --  2t882.  R/W  reauett*  totallnS  2f882.  blocks  with  no  errors 

L^Li:  --  2f931.  R/W  reauests  totaling  2f931.  blocks  with  no  Mrrori. 

DHO:  --  S>902«  R/W  reauests  totaling  5.902.  blocks  with  no  errors 

mho:  --  652.  R/W  reauests  totaline  652.  records  with  no  errors 
AST's  executed:  15>725. 
Idle-loop  iterations!  6r798. 

>REN  SIO 
>» 

>l       «  lOX  TEST  COMPLETED  AT  14!34!5'«   * 

>»       *   UTILITIES  TEST  STARTED  AT  14!34:54   « 

>l       *  CHP  VERIFICATION  « 

>l 

>TIM 

14!34!SS  20-JUL-81 

>PIP  COMPAR.CMD-SIOE.CMD 

>!  INVOKE  CHP  TO  COMPARE  IDENTICAL  FILES 

>CMP  TIJ-COMPAR. CMDfSIOE.CMD 

1)  DL1!C2»300]C0MPAR.CMDI  1 

2)  DLl![:2f300]SI0E.CHDn 

No  differences  found 
TI  !-C0MPAR. CMDfSIOE.CMD 

>•  NO  DIFFERENCES  SHOULD  HAVE  BEEN  FOUND 
>! 

>!  INUOKE  CMP  TO  COMPARE  DIFFERING  FILES 
>CMP  TI!=iFILEl.  »FILE2. 

1)  OLi:C2»3001FILEl. >  1 

6  .»  IF  CMP  IS  FUNCTIONING»  THIS  LINE  FROM  FILEl.  IS  DIFFERENT. 

7  .»  THE  REST  OF  THE  LINES  ARE  IDENTICAL. 

2)  DLi:C2f300]FILE2.  (1 

6  .»  THIS  LINE  IS  THE  FILE2.  LINE  WHICH  DIFFERS  FROM  THE  ABOVE. 

7  .)  THE  REST  OF  THE  LINES  ARE  IDENTICAL. 

1  differences  found 
TI!»FILE1. »FILE2. 

>!  ONE  DIFFERENCE  SHOULD  HAVE  BEEN  FOUND 
>PIP  COMPAR.CMDJ«/DE 
>» 

>TIM 

14!34!59  20-JUL-81 
>» 

>♦       «  CMP  VERIFICATION  COMPLETE  « 
>» 

>»       »  FLX  VERIFICATION  « 
>INS  LB!C1»543FLX/TASK=. . .FLX 

DMO  —  TTO!     Disiiounted  froe  DKO!     ***    Final  dismount  initiated  ««« 
14:35!14  ***    DKO:  --  Disnount  complete 
>FLX  DKO!/ZE/DO 
>FLX  DKO ! /DO°NUL 1 . HAC/RS i NUL2 . MAC  >  NUL3 . MAC 

(continued  on  next  page) 


9-11 


USER  ENVIRONMENT  TEST  PACKAGE  (UETP) 

Example  9-1  (Cont.)   Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 
>FLX  DKOJ/DO/LI 

Directors       DKtC2f300] 
20-JUL-Bl 

NULl.MAC        If,      20-JUL-81   <233> 
NUL2.HAC        19,  20-JUL-81   <233> 

NUL3.MAC        If,      20-JUL-81   <233> 

Total  of  57.  blocki  in  3.  files 

>FLX  DKOJ/ZE/RT 

>FLX  DK0:/RT-NULl.MAC.NUL2.MACfNUL3.MAC 
>FLX  DKO:/RT/LI 

DIRECTORS         DKO: 
20-JUL-81 

NULl   .MAC  19.  20-JUL-81 

NUL2   .HAC  19.  20-JUL-81 

NUL3   .MAC  19.  20-JUL-81 

<  Unu»ed  >  4721. 

4721 .  Free  blocks 

Total  of  57.  blocks  in  3.  files 

>REM  FLX 

>»        «  FLX  VERIFICATION  COMPLETE  « 

>l 

>»       «  DMP  VERIFICATION  » 

>» 

>TIME 

14:35J09  ?0-JUL-81 

>INS  LB:C1»54DDMP/TASK=. . .DMP 

>DMP  Ti:=ASRC.XXX/AS/RC 

Vkibf    of  DLi:C2r3003ASRC.XXXf  1  -  File  ID  55»1,0 

Record  number  01.  -  Size  16.  butes 

000000  DMP  UORKS! 

»«»  EOF  »»« 

>REMOVE  ...DMP 

>TIME 

14:3S:il  20-JUL-81 

>l) 

>»       *  DMP  VERIFICATION  COMPLETE  « 
>) 

>»       «  CREF»  PMD  AND  PRT  VERII ICATION  « 
>» 

>i       THIS  ROUTINE  OPERATES  THE  FOLLOWING  UTILITIES: 

>>       MAC»TK3.CREF.PMD>PRT 

>» 

(continued  on  next  page) 
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>l  IF  ALL  ARE  FUNCTIONALf  AN  EXAMPLE  OF  A  MACRO  LISTING  WITH  SYHBOL 

>(  AND  MACRO  CROSS-REFERENCE  LISTINGS  ATTACHED  IE  SPOOLED  TO 

>»  THE  LINE  PRINTER.  A  TASK  WILL  BE  RUN  AND  IT  WILL  CRASH  AND  A 

>»  POST-MORTEM  DUMP  LISTING  OF  THE  CRASHED  TASK  IS  SPOOLED. 

>l 

>TIM 

14:35:12  20-JUL-81 

>INS  LB:C1»54DCRF/TASK=.. .CRF 

UFD  sy:ci.*3 

>» 

>MAC  CRTESTfCRTEST/CR«CRTEST 

>TKB  CfV.EST/PM'CRTEST 

>INS  CRTEST 

>i 

>i 

>RUN  CRTEST 

>S 

14:35:20   Task  'CRTEST'  terminated 

Odd  address  or  other  trap  four 

R0=000000 

Rl=llllll 

R2=022222 

R3=033333 

FC4=^044444 

R5=05555S 

SP=001172 

PC^-001236 

PS=170001 

PostnorteiTi  DijitiF'  will  be  Generated 
>REM  CRF 
>TIM 

14:35:20  20-JUL-81 
>f 

>i  *    CREF.  PMD  AND  PRT  VERIFICATION  COMPLETE  « 

>» 

>; 

>J       *  DSC  VERIFICATION  « 

>» 

>TIM 

14:35:21  20-JUL-81 

>INS  LB:Clf54DDSC 

>SET  /UIC=C2.3003 

>; 

>»  BECAUSE  YOU  DO  NOT  HAVE  A  F'.OPPY  DRIVE  OR  DEC  TAPE. 

>>  AN  AUTOMATIC  VERIFICATION  0!  DSC  OPERATION  IS  DEEMED 

>i    IMPRACTICAL. 

>i    THE  DSC  TEST  IS  BEING  SKIPPED. 

>» 

>REM  DSC 

>PIP  «.TMPI«/DE 

PIP  —  No  such  file(s) 

SY0:C2f300D«.TMP>« 

>; 

>t  »  LBR  VERIFICATION  « 

>i 

>TIME 

14:53:52  20-JOL-81  ^ 

>!    Create    an   ob-iect    nodule    librar*^* 

>LBR  objlib/cr: : ::oBJ 

>!  Insert  three  object  nodules  into  the  librarw. 
>LBR  0BJLIB/IN=0BJCT1.0BJCT2.0BJCT3 

(continued  on  next  page) 
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>l  Insert  an  •xistinfl  nodule  into  the  librerw  (error  exF-scted). 

>LBR  0BJLIB/IN=0BJCT2 

LBR  --  «FATAL»-Duplicate  module  nsne  ■0BJ2   '  IN  0BJCT2.06J>2 

>!  Replace  two  existing  Modules. 

>LBR  OBJ'  IB/r'='-0BJCT1.0BJCT2 

Module  *uBJl   '  replaced 


Hodule  ■0BJ2 


replaced 


>l  Displaw  the  contents  of  the*  object  Riodule  libraru> 
>LBR  OBJLIB/LE/FU 

Directors  of  file  OBJLIB.OLBIl 

Object  module  library  created  bw:   LBR  V06.00 

Last  insert  occurred  20-JUL-til  AT  14:54:02 

HNT  entries  allocated:  256f  AVAILABLE:  253 

EPT  entries  allocated:  512$  AVAILABLE:  506 

File  space  available:  21897  UORDS 

Recoverable  deleted  space:  00150  UORDS 

««  Module:OBJl     Size:00075   Inserted : 20- JUL-81  Ident:iD  1 


ENT$A1   ENT»B1 


«*  Module:0BJ2     Size:00075   Inserted:  20- JUL-81  Ident:iri  2 


ENT«A2   ENT«B2 


»»    Hodule:0BJ3  Size:00075      Inserted: 20- JIJL-81    Ident:iD    3 


ENT«A3   ENT«B3 


>PIP  OBJLIB.*J»/DE 

>TIME 

14:54:05  20-JUL-81 

>>       »  LBR  VERIFICATION  COMPLETE  » 

>i 

>i  *  PAT  VERIFICATION  * 

>; 

>TIhE 

14:54:06  20-JUL-81 

>INSTALL  LB:Clf543PAT/TASK=.. .PAT 

>!  Create  an  updated  object  file.       ** 

>PATCH  PATCHD.PAT=OBJCTlfPATCHl 

>!  Compare  the  updated  object  file  with  one  of  known  aualitu. 

>CMP  Ti:=PATCHD.PAT.PATCHD.XXX 

1)  DLi:C2i300DPATCHD.PAT}l 

2)  DLi:C2f300]PATCHD.XXXf 1 


No  differences  found 
TIJ=PATCHD.PAT»PATCHD.XXX 
>PIP  «.PATf*/DE 
>REMOVE  ...PAT 


(continued  on  next  page) 
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>TIME 

14:54:10  20-JUL-81 

>»       «  PAT  yERIFICATION  COMPLETE  * 

>» 

>»       «  SLP  VERIFICATION  « 

>» 

>TIME 

14:54:10  20-JUL-81 

>i     Invoke  the  SLP  Editor  to  edit  a  data  file. 

>SLP  eSLPChli 

>»  Verify  that  the  editins  was  properl«  performed. 

>CMP  Ti:=OUTPUT.ijLP»SLPOUT.XXX 

1)  DLi:C2»300D0UTPUT.SLP;i 

2)  DLi:C2»3003SLPOUT.XXXf 1 

No  differences  found 
TI :=OUTPUT.SLP»SLPOUT.XXX 
>PIP  «.SLPJ«/nE 
>TIME 

14:54:14  20-JUL-81 

>t  *    SLP  VERIFICATION  COMPLETE  * 

>»       »   UTILITIES  TEST  COMPLETED  AT  14:54:14   « 
>i  «   MCR  COMMANDS  TEST  STARTED  At  14:54:14   « 

>i  *    ALLf  BAD.  INI.  MOU.  UFD.  VFY.  DM0  AND  DEA  VERIFICATION  » 

>> 

>f  THIS  ROUTINE  CHECKS  THE  DISK-ACCESSING  MCR  COMMANDS  ALL.  INI.  BAD. 
>i    MOU.  UFD.  VFY.  DM0  AND  DEA. 

>i    ALL  AND  DEA  ARE  TESTED  ONLY  FOR  A  MULTI-USER  SYSTEM. 
>'t     THIS  ROUTINE  REQUIRES  EITHER  ONE  SCRATCH  DISK  DRIVE  OR  DECTAPE 
>;  OR  ANSI  SUPPORT  FOR  MAGTAPE.   IT  WILL  NOT  USE  A  PUBLIC  DISK. 
>f     IF  ONLY  MAGTAPE  IS  AVAILABLE.  A  SUB-SET  OF  THE  TEST  IS  RUN. 

>; 

>INS  LB:$BAD/TASK=. , .BAD 

>INS  LB:«VFY/TASK=. . .VFY/INC=10000 

>DEV  dk: 

DKo:  tto:  -  private  loaded 

>ACs  dko:/blks=o. 

ACS  --  File  not  in  use 

>DMo:  dko:/dev 

DM0  --  Volume  not  Mounted  DKO: 

>dea  dko: 
>ALL  dko: 
>BAD  dko: 

BAD  —  dko:  Total  bad  blocks=  1. 

>INI  DK0:SCRTCH/BAD=CAUT0]/EXT=4/FPR0=CR.RW.RUE.RWED3/INDX=BEG/VI 

»*  VOLUME  INFORMATION  FOR  DKO:  ♦» 


Label 

/BAD 

/CHA 

/EXT 

/FPRO 

/INDX 

/INF 

/LRU 

/MXF 

/PRO 

/UIC 

/WIN 


SCRTCH 

CAUTO: 

CJ 

4. 

CR.RU.RUE.RUED] 

BEG 

147. 

3. 

294. 

CRWED.RUED.RWED.RUED3 

ci.n 

7. 


THEORETICAL  MAXIMUM  FILES  =  2357. 


(continued  on  next  page) 
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>IM7  DK0tSCRTCH/INDX-BE6/INF»20/LRU"3/MXF»100/FR0>=CR»RM.RWE»RUEI"]/Vl 
»»  VOLUME  INFORHATION  FOR  DKOt  «« 


LABEL 

a: 

SCRTCH 

/BAD 

& 

CAUTQJ 

/CHA 

= 

C] 

/EXT 

= 

5. 

/FPRO 

=: 

CRHED>RWED>RWEDrR] 

/INDX 

m 

BE» 

/INF 

s 

16. 

/LRU 

X 

3. 

/MXF 

s 

6A, 

/PRO 

s 

CRrRUfRUEfRUED] 

/UlC 

s 

Clf  13 

/WIN 

s 

7. 

THEORETICAL  MAXIMUM  FILES  =  2357. 

>INI  DK0JSCRTCH/UIC=C2,300  3/UIN=7/VI/INF=20 

**    VOLUME  INFORMATION  FOR  OKO:  «« 


LABEL 

a 

SCRTCH 

/BAD 

s 

CAUTOl 

/CHA 

= 

CD 

/EXT 

= 

5. 

/FPRO 

s 

CRWED>RUEDfRUED>R] 

/INDX 

s 

MID 

/INF 

- 

16. 

/LRU 

s 

3. 

/HXF 

=: 

294. 

/PRO 

a 

CRUED > RUED f RUED > RUED  3 

/UIC 

s 

C2»3003 

/WIN 

s 

7. 

THEORETICAL  MAXIMUM  FILES  =  2357. 

>MOU  DKO:SCRTCH/VI/OVR 

VoluKe  Infor»3tion 

Class:        Files-11 

Device:       DKOO 

Voluiie  labeliSCRTCH 

Owner:        C2f2003 

Protection:   CRUCD»RUCD»RUCD»RgCD3 

Default:      CRWEDtRUED>RWED>R3 

Processor:    FllACP 

>DEV  dk: 

DKO:  TTO:  -  PRIVATE  MOUNTED  LOADED  LABEL=SCRTCH 

>PIP  DK0:C0.03/FU 

Directory  DK0:C0>03 

20-JUL-81  14:56 

INDEXF.SYSJl         (1,1)  24. /24.  20-JUL-81  14:56 

Clfl3     CRUED>RUEDfRUEDfR3 
BITMAP. SYSJl         (2.2)  3./3.  "^O-JUL-Sl  14:56 

Cl>13     CRUEDfRUED>RUED>R3 
BADBLK.SYSri         (3»3>  2./2.  20-JUL-81  14:56 

C1>1]     RWEDrRUED>RUEDfR3 
000000/DIRJl         (4,4)  l.J/1.  20-JUL-81  14:56 


Cl>13     CRUED>RUEDfRUED»R3 


(continued  on  next  page) 
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CORIHG.SYSU         (5t5)  O./O.  20-JUL-81  14J56 

Clrl]     CRUEDfRUEDfRWEDfRl 

Total  of  30. /30.  blocks  in  5.  files 
>PIP  DKO:/FR 

DKO:  has  4770.  blocks  fre«>  30.  blocks  used  out  of  4800. 
Largest  contiguous  space  =  2383.  blocks 

289.  file  headers  are  freei  5.  headers  used  out  of  294. 
>VFY  DKO:/LO 

0.  Lost  files  were  found 

>VFY  DKO:/LI 

Listind  of  index  on  IiKO: 


File  ID  OOOOOlrOOOOOl  INDEXF.SYSfl  Owner  T. 

File  ID  000002*000002  BITMAP. SYSH  Owner  C 

File  ID  000003f 000003  BADBLK.SYS$1  Owner  C 

File  ID  000004*000004  000000. DIRU  Owner  C 

File  ID  OOOOOSfOOOOOS  CORING. SYSU  Owner  C 
>VFY  DKO:/FR 


tl] 


DKO:  has  4770.  blocks  free»  30.  blocks  used  out  of  4800. 

>VFY  DKO:/RC 

Read  check  of  files  on  DKO:  -  Blockins  factor  13. 

>UFD  DK0:C2f300]/ALL0C=34./PR0=nRfRW»REW.REMDD 

>PIP  DK0SC2»3003=DK0}C0»03BADBLK.SYS 

>PIP  DK0JC2»3003/FU 

Directors  DKO:C2f300] 

20-JUL-81  14156 

BAOBLK.SYSJl         (7.1)  2./2.  20-JUL-81  14:56 

C2>300]   CRWEDfRUEDfRWEDfR] 
Total  of  2./2.  blocks  in  1.  file 
>DMQ  DKO*. 

DHO  —  TTO:     discounted  from  JKOi     »«4cFinal  diSKOunt  initiated*** 
14;S6:32   ***DKO:  --  DisMOunt  co»plete 

>DEA  DKO: 

>DEV  dk: 

DKO:  LOADED 

>REM  VFY 

>REM  BAD 

>»       «  ALL.  BAD*  INI>  HOU*  UFD»  VFY>  DHO  AND  DEA  « 

>»  «  VERIFICATION  COHPLETE  » 

>f  »   MCR  COMHANDS  TEST  COMPLETED  AT  14:58:58   « 

>» 

>»       *   INTERACTIVE  UTILITIES  TEST  STARTED  AT  14:58:59   « 

>l 

>l       «  INTERACTIVE  UTILITIES  VERIFICATION  * 

>» 

>»       DEPRESS  CARRIAGE  RETURN  TO  CONTIfJJE  FROM  EACH  EDITOR 

>»       SUCCESSFULLY  INVOKED  AND  CTRL  Z  TO  EXIT  FROM  ACNT. 

>TIM 

14:58:!59  20-JUL-81 

>EDI    QQPQ.XXX 

CCreatind   new   file3 

IniP'Ut 

TESTING  TEST  IN6 

(continued  on  next  page) 


9-17 


USER  ENVIRONMENT  TEST  PACKAGE  (UETP) 

Example  9-1  (Cont.)   Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 
>AEiO  EOI 

14:59:20   Task  '...EDI-  terminated 

Aborted  via  directive  or  CLI 
And  with  pending  I/O  reauests 

>f 

>PIP  aQOQ.XXX»«/DE 

>INS  LBJC1»543EDT 

>EDT 

EDT> 

>ABO  EIiT 

14:59:32   Task  '...EDT'  terminated 

Aborted  via  directive  or  CLI 
And  with  peridind  I/O  reoucsts 

>REM  EDT 

>INS  LB:C1»54]ZAP 

>ZAP 

ZAP> 

>ABO  ZAP 

14:59:42   Task  '...ZAP'  terminated 

Aborted  via  directive  or  CLI 

And  with  pending  I/O  reouests 

>» 

>REM  ZAP 

>j:NS    LB:Clf543ACNT/TASK  =  ACNT 

>RUN    ACNT 

«  ACCOUNT  FILE  MAINTENANCE  PROGRAM  * 
Options  are:  A  -  ADD»  C  -  CREATE  FILE»  D  -  DELETE,  E  -  EXAMINE, 
L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  "Z 
OPERATION  COMPLETE 

> 

>REM  ACNT 

>TI« 

15:00:14  20-JUL-81 

>'f 

>i  t       INTERACTIVE  UTILITIES  TEST  COMPLETED  AT  15:00:i5   « 

>i 

>l  IF  ANY  ERRORS  HAVE  BEEN  LOGGED  BY  THE  ERROR  LOGGER,  YOU  SHOULD  INVESTIGATE 

>f    FURTHER  BY  RUNNING  THE  ERROR  LOGGER  REPORT  GENERATOR  <RPT) 

>i    AFTER  THE  UETP  COMMAND  FILE  EXITS. 

>ELI  /SHOW 

Error  Loaai.-i-  Stctuc     20-JUL-81   15:00:27 

Loaaina:  On      Limiting:  On 

Lofl  File:  SY0:C1,6DL06.ERR     File  ID:  DLO:  320,111 

Backup  File:  SYO: CI ,6DBACKUP.ERR 


(continued  on  next  page) 
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Device 

Hard  Error 

Soft  Error 

QIO 

Naae 

Count/L 

iBit 

Count/L 

init 

Count 

CBO: 

0./5, 

0./8. 

0. 

DKO: 

0./5. 

0./8. 

0. 

DLO: 

0./5. 

0./8. 

12292. 

DLi: 

0./5. 

0./8. 

6229. 

DHO: 

0./5. 

0./8. 

5970. 

DM1 : 

0./5. 

0./8. 

0. 

DYO: 

0./5. 

0./8. 

0. 

(Offline) 

DYi: 

0./5. 

0./8. 

0. 

(Offline) 

HMO:     0./5.  0./8.  19. 

>ELI  /-LOG 

ERRL06  —  Error  LoasinS  stopped 

>REM  ELI 

>J  RESTORE  SYSTEM  TO  PRE-UETP  STATE 

>REM  MAC 

>REM  TKB 

>REM  CMP 

>REM  LBR 

>REM  EDI 

>i 

>»      *t**t*********t*****t*****t*t*****t********t****tt*****t*t******t*t 

>l      *  * 

>l       «  RSX-llM   V4.0  UETP  PROCEDURE  COMPLETED  AT  15J0i:05  ON  20-JUL-81  « 

>i    *  » 

>pip  *.»/pu:4 

>REM  DEFINE 

>ABO  T2RMD 

15:0i:il   Task  'T2RMD  •  terminated 

Aborted  via  directive  or  CLI 

>REH  T2RMD 

>REMOVE  CRTEST 

>P.''P  TAILOR. DATf«/DE/NM 

>PIP  DVLSET.CMDJ»>DVl REM. CMDJtfREMUTL.CMDJ* fCONFIG.CMD J «/DE/NM 

>PIP  UETPASM.CMD  J*  rUETPBLD.CMDXfRUNLOG.  DAT  »«fERRLOG.  DAT  »*»IOXCNF.  DAT  f*/DE/ 

>PIP  CRTEST. OBJ;«» OB JCTl . OBJJ «. OB JCT2 . OBJJ « iOBJCT3 . OBJi «. DUMMY . TSKf */DE/NM 

>PIP  LOGGER.TSK»«»QTRUN.TSK»*fNULl.TSKf *fNUL2. TSKf* rNUL3. TSKf «/DE/NM 

>PIP  CRTEST. LSTr«, DEFINE. TSKJ^.CF  EST . TSK i */DE/NM 

>SET  /UIC=C2.3003 

>9    <EOF> 

> 
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VIRTOAL  MONITOR  CONSOLE  ROOTINE  (VHR) 


The  Virtual  Monitor  Console  Routine  (VMH)  prograns  are  privileged 
system  tasks  on  RSX-llM  and  RSX-llM-PLUS  that  allow  you  to  configure 
an  RSX-llM  or  RSX-llM-PLUS  system  image  file,  respectively.  VMR 
allows  you  to  issue  Monitor  Console  Routine  (MCR)  commands  that  are 
directed  co  the  disk  image  of  a  system  rather  than  to  the  current 
running  system.  The  system  image  file  that  you  configure  using  VMR 
can  later  be  booted. 

VMR  supports  a  number  of  MCR  commands  described  in  the  RSX-llM/M-PLUS 
MCR  Operations  Manual .  With  the  exception  of  the  SAVF.  command,  VMR 
commands  have  the  same  syntax  and  semantics  as  their  MCR  counterparts. 

Error  messages  for  VMR  are  given  in  Section  10.6. 


10.1   STARTING  VHR 

You  can  start  VMR  four  ways.  The  first  three  methods  apply  when  you 
have  installed  VMR  and  it  is  ready  to  be  executed.  The  fourth  method 
installs  VMR  automatically,  executes  it,  and  then  removes  it  on  exit. 

Nathod  1: 

>VMR  §indirect 

The  system  loads  VMR  and  executes  the  specified  indirect  command 
file.   VMR  then  exits. 

Method  2: 

>VMR 

The  system  loads  VMR,  and  VMR  responds  with  the  following  prompt: 

ENTER  FILENAME: 
Itethod  3: 

>RUN  VMR 

The  system  loads  VMR,  and  VMR  responds  with  the  following  prompt: 

ENTER  FILENAME: 
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Method  4: 

>RUN  5VMR 

The  system  installs  VMR  from  the  pseudo  device   LB:    under  the 

system   UFD  (normally,  [1,50]  for  unmapped  systems  and  [1,54]  for 

mapped  systems)   and   loads   it.    VMR   then   responds  with  the 
following  prompt: 

ENTER  FILENAME: 

In  all  starting  methods  except  Method  1,  VMR  prompts 

ENTER  FILENAME: 

At  this  point,  you  specify  the  file  that  contains  the  image  of  the 
RSX-llM  or  RSX-llM-PLUS  system  you  want  to  modify. 

VMR  expects  to  find  a  symbol  definition  file  of  the  same  name  as  that 
of  the  system  image  file,  but  with  a  file  type  of  .STB,  on  the  same 
device  and  under  the  same  UFD  as  those  of  the  system  image  file 
(except  wnen  you  use  the  /IM  switch;  see  Section  10.2).  For  example, 
suppose  you  enter  the  following  file  specification  in  response  to  the 
prompt : 

RSXllM.SYS 

A  corresponding  file,  RSXllM.STB,  must  exist  that  contains  the  symbol 
definitions  for  the  RSXllM.SYS  system  image. 

NOTE 

If  the  system  image  file  you  wish  to 
modify  is  not  on  the  device  assigned  as 
SY:  and  LB:,  you  must  assign  both  SY: 
and  LB:  to  the  system  image  file's 
physical  device. 

The  system  image  and  symbol  definition  files  are  in  the  standard 
format  produced  by  the  RSX-llM/M-PLUS  Task  Builder. 

Upon  receiving  a  valid  file  specification,  VMR  opens  and  reads  the 
symbol  definition  file.  It  also  opens  the  system  image  file  and 
verifies  that  the  file  is  actually  a  system  image. 

On  RSX-llM-PLOS,  if  the  system  image  file  you  specify  does  not  have 
Executive  data  space  support,  VMR  prompts  with: 

VMR> 

If  the  system  image  file  you  specify  does  have  Executive  data  space 
support,  VMR  loads  the  data  space  and  prints  the  following  message: 

Loading  Executive  data  space 
Data  space  loading  completed 

VMR  then  prompts  with: 

VMR> 
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You  can  now  enter  any  valid  VMR  command  or  terminate  VMR  by  typing 
CTRL/Z. 

If  you  used  Method  1  to  start  VMR,  the  first  line  in  the  specified 
indirect  command  file  must  contain  a  file  specification  for  the  system 
image  file  that  is  to  be  modified. 

In  addition  to  specifying  an  indirect  command  file  to  start  VMR,  you 
can  also  enter  the  following  any  time  that  VMR  prompts  for  input: 

@f ilespecif ication 

This  directs  VMR  to  extract  command  input  from  the  specified  file 
until  it  reaches  an  end-of-file  and  then  to  return  to  the  terminal  for 
further  input.  This  feature  of  VMR  is  useful  when  you  want  to  repeat 
a  series  of  commands  for  several  generated  systems  (INSTALL  commands, 
for  example) . 

VMR  allows  two  levels  of  indirect  command  files.  This  means  you  can 
invoke  a  second  command  file  from  within  the  first  file.  Trying  to 
invoke  another  file  from  within  the  second  file  results  in  an  error 
message. 


10.2   VMR  FILE  SPECIFICATIONS 

VMR  accepts  the  standard  RSX-llM/M-PLUS  file  specification  format 
ddnn: [g,m] f ilename.type;ver [/IM] 


ddnn: 


The  device  unit  on  which  the  volume  containing  the  desired  file 
resides  (for  example,  DM0:  or  DTI:).  The  name  consists  of  two 
ASCII  characters,  followed  by  an  optional  1-  or  2-digit  octal 
'^nit  number.   The  default  device  is  SYO:. 


[g»in] 


The  UFD  in  which  the  file  is  listed.  The  variables  g  and  m  are 
octal  numbers  from  1  to  377  that  represent  the  file  owner's  group 
and  member  number,  respectively.  The  brackets  are  a  mandatory 
part  of  the  UFD  syntax.  The  default  is  the  UIC  under  which  VMR 
is  running . 


filename 


The  name  of  the  file.  An  RSX-llM/M-PLUS  file  name  can  consist  of 
up  to  nine  alphanumeric  characters.  The  file  name  and  file  type 
are  always  separated  by  a  period  (.).  You  must  specify  the  file 
name.   No  default  is  applied. 


type 


The  file  type,  consisting  of  up  to  three  alphanumeric  characters. 
The  file  type  and  version  number  are  always  separated  by  a 
semicolon  (;).  The  defaults  are  .SYS  for  system  image  files, 
.TSK  for  task  image  files,  and  .CMD  for  indirect  command  files. 
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V«X 


/IM 


The  version  number  in  the  range  of   0   through 
default  is  the  highest  version  in  the  UFD. 


77777(8)  . 


The 


A  switch  that,  when  applied  to  the  system  image  file 
specification,  overrides  the  VMR  requirement  for  the  symbol 
definition  file.  When  you  use  the  /IM  switch  with  the  file 
specification,  the  only  command  VMR  will  accept  is  the  SAVE 
command. 

This  is  the  only  switch  provided  with  VMR.  You  use  it  to  write 
non-RSX-llM/M-PLUS  system  images  to  secondary  media  in 
bootstrappable  format.  The  switch  is  also  useful  when  you  use  an 
RSX-llM/M-PLUS  system  as  a  host  system  for  developing  small, 
memory-resident  systems  that  must  be  loaded  from  a  serial  medium 
(such  as  paper  tape) . 


10.3   CONHAND  SYNTAX 


You  do  not  have  to  give  an  entire  command  name  to  VMR.  VMR  accepts 
three  characters  and  then  searches  for  a  space  or  tab  followed  by  the 
command  parameters  or  by  a  RETURN  if  there  are  no  parameters.  Because 
VMR  requires  a  space  or  a  tab  preceding  parameters,  VMR  does  not  allow 
embedded  spaces  in  a  command  name.  If  you  enter  a  command 
incorrectly,  VMR  displays  ^n  error  message  at  your  terminal. 

The  following  example  illustrates  the  format  of  the  TIME  command. 
Note  that  the  square  brackets  in  the  example  indicate  that  the  "E"  is 
optional: 

VMR>TIM[E](lI) 


10.3.1  Keywords 

Some  commands  use  keywords  that  apply  to  the  command  argument.  A 
keyword  consists  of  a  slash  (/)  ,  followed  by  an  alphanumeric 
identification,  and,  optionally,  followed  by  an  equal  sign  (°)  and  the 
value  of  the  keyword,  as  follows: 

/keyword" value 

You  can  enter  keywords  in  any  order.  For  example,  the  INSTALL  command 
requires  a  file  name  parameter  specifying  the  task  to  be  installed. 
You  can  append  keywords  to  the  file  name.  One  such  keyword,  /TASK, 
specifies  the  name  under  which  the  task  is  to  be  installed. 

VMR>INS  TEST.TSK/TASK=SUPER 

This  command  line  causes  the  task  contained  in  the  file  named  TEST.TSK 
to  be  installed  with  the  name  SUPER.  Keywords  are  command-specific 
and  are  defined  with  each  command  (Section  10.5). 
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10.3.2  Comments 

VMR  treats  a  line  of  text  as  a  comment  if  the  first  character  in  the 
line  is  a  semicolon  (;).  In  addition^  you  can  use  the  exclamation 
mark  (1)  to  delimit  comments  within  a  command  line.  The  fi-st 
exclamation  mark  starts  the  comment  and  the  next  exclamation  mark  or 
RETURN  terminates  the  comment.  VMR  ignores  all  text  between  the  tvTO 
exclamation  marks.   For  example: 

VMR>;   THIS  LINE  IS  A  COMMENT 

VMR>TAS  ITHIS  IS  A  COMMEi^T  STRING! 

Comments  are  especially  useful  to  clarify  commands  in  VMR  indirect 
command  files.  (Refer  to  the  RSX-llM/M-PLUS  MCR  Operations  Manual  for 
more  information  on  indirect  command  files.) 


10.4   COMHARD  SOHNART 

The  VMR  commands  described  in  this  chapter  are  listed  below  by 
category.  The  detailed  descriptions  of  the  VMR  commands  are  given  in 
Section  10.5  in  alphabetical  order. 


Initialization  Commands 
ASSIGN 


COtiPIGURATION 

INSTALL 

LOAD 

REDIRECT 

SAVE 

SET 

TIME 


Define,  delete,  or  display  a  global  logical  device 
assignment.  List  current  assignments  on  console 
terminal . 

(RSX-11M-PL08  systems  only.)  Display  syetMi 
configuration,  or  change  a  device's  CSS  or  vector 
address. 

Install  a  task  into  the  system  image. 

Load  a  device  driver. 

Redirect  I/O  requests  from  one  physical  device  to 
another. 

Write  the  system  image  file  onto  a  seconds,  y  medium  in 
bootstrappable  format. 

Set  a  variety  of  system  and  terminal  characteristics. 
This  command  has  both  device  characteristics  keywords 
and  memory  allocation  keywords. 

Enter  time  and/or  date  into  the  system  imager  diii^play 
the  time  and  date. 


UNLOAD 


Unload  a  device  driver. 


Informational  Commands 

DEVICES         Display  a  list  of  the  peripheral   devices  defined   in 
the  system  image. 


LUNS 


Display  the  list  of  LUN  assignments  for   an   indicated 
task. 
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PARTITIONS       Display  the  list  of  partitions  defined  in   the   system 
image . 

TASKLIST        Display  a  list  of  the  tasks  installed   in   the   system 
image. 

On  RSX-llH-PLOS,  the  display  lists  tasks  installed  in 
primary  pool  and  then  tasks  installed  in  secondary 
pool . 

Task  Control  Conunands 

ALTER  Alter  the  priority  of  a  task. 

CANCEL  Cancel  the  time-based  initiation  requests  for  a  task. 

FIX  Fix  a  task  in  the  system  image. 

REASSIGN        Change  a  task's  LUN  assignment. 

REMOVE  Remove  a  task  from  the  system  image. 

RUN  Schedule  a  task's  activation.   The  task  may  run   after 

one  clock  tick,  after  a  delay,  or  in  synchronization 
with  the  system  clock.  Periodic  rescheduling  is 
optional . 

UNFIX  Unfix  a  task  from  the  system  image. 


10.5   VMR  COMMAND  DESCRIPTIONS 

The  following  subheadings  are  used  in  the  detailed  command 
descriptions  in  this  section.  Subheadings  that  do  not  apply  to  a 
particular  command  are  omitted  from  the  command  description. 

Command  Acronym 

This  subheading  consists  of  the  minimal  form  of  the  command  name 
in  capital  letters.  The  acronym  is  at  tne  outside  margin  of  each 
page . 

Command  Name 

This  subheading  consists  of  the  full  command  name  in  capital 
letters.  The  text  following  the  name  describes  the  command's 
function. 

Format 

The  command  line  format  is  given  and  all  parameters  are  listed. 
Parameters 

Parameters  are  listed  and  described. 
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Keywords 

Keywords  are  listed  and  described. 
Examples 

Examples  of  the  command  output  are  shown. 
Hotes 

A  list  of  special  considerations  that  may  assist  you  in  using  the 
command  properly  appears  under  this  subheading. 
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ALT 

ALTER 

Use  the  ALTER  command  to  change  the  static  priority  of  an   installed 
task. 

Format 

ALT(ER]  taskname  /PRI«prior ity 
Paraaeters 
taskname 

The  name  of  the  task  whose  priority  is  to  be  altered. 
/PRI 

The  keyword  that  changes  the  task's  static  priority, 
priority 

The  new  priority  to  be  assigned  to  the  specified  task,  from  1   to 
250  (decimal) . 

Example 

VMR>ALT  TEST  /PRI«248. 

A.ters  the  static  priority  of  task  TEST  to  248(10). 
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ASN 


ASSIGN 

Use  the  ASSIGN  command  to  define,  delete,  or  display  logical-device 
assignments.  Logical -device  assignments  are  a  way  to  associate 
logical  names  with  physical,  pseudo,  or  logical  devices.  When  you 
assign  a  logical  name  to  a  pseudo  or  logical  device,  the  system 
resolves  the  assignment  to  the  associated  physical  device. 

There  are  three  types  of  logical-device  assignments:  global,  local, 
and  login.  VMR  supports  the  manipulation  of  global  assignments  only. 
Global  assignments  apoly  to  all  tasks  in  the  running  system.  See  the 
RSX-llM/M-PLOS  MCR  Operations  Manual  for  information  on  local  and 
login  assignments. 

A  logical  device  name  has  the  same  syntax  as  that  of  a  physical  device 
unit.  It  consists  of  a  .^-character  ASCII  name  (alphabetic)  and  an 
optional  1-  or  2-digit  octal  unit  number,  followed  by  a  colon  (:). 
The  2-character  name  can  be  either  equivalent  to  a  standard 
RSX-llM/M-PLUS  device  name  (for  example,  DK:)  or  formed  by  two  letters 
picked  at  random  (for  example,  ZZ:). 

When  you  install  a  task  or  the  system  executes  an  ASSIGN  LUN 
directive,  the  system  scans  the  logical  device  table  before  it  scans 
the  physical  device  table  in  searching  for  a  specified  device.  As  a 
result,  you  can  define  logical  device  names  that  are  identical  to 
physical  device  names  even  though  the  logical  and  physical  device 
names  do  not  refer  to  the  same  physical  device.  The  system  resolves  a 
specified  device  name  to  the  first  matching  table  entry  found.  If  a 
logical  device  name  is  identical  to  a  physical  device  name,  the 
logical  name  has  precedence. 

Foraats 

ASN  ppnn:-llnn:/GBL 

Define  a  global  assignment  that  associates  the  logical   name 
linn:   with  device  ppnn:. 

ASN  /GBL 

Display  all  global  assignments  for  the  system. 

ASN  -[linn:) /GBL 

Delete  the  specified  global  logical  device  assignment  or,  if 
you  omit  linn:,  delete  all  global  assignments. 

Paraneters 

PP 

A  physical,  logical,  or  pseudo  device  name, 
nn 

A  unit  number . 
11 

A  logical  device  name. 
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ASN  (Cont.) 

Bxaapl** 

VHR>ASN  DM:-GBO:/GBL 

Defines  the  global  logical  device  name  GBO:   and   assigns   it   to 
DM:. 


VMR>ASN  /GEL 
GBO:  DM0:   Global 

Lists  all  global  assignments. 


VMR>ASN  «=/GBL 

Deletes  all  global  assignments. 
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CAN 


CANCEL 

Use  the  CANCEL  conunand  to  cancel  time-based  initiation  requests  for  a 
task.  These  requests  result  from  the  RUN$  directive  or  any  of  the 
time-synchronized  variations  of  the  VMR  RUN  command. 

CANCEL  does  not  affect  the  execution  of  the  task  that  may  be  active  in 
the  saved  system  image.  It  removes  only  the  time-based  schedule 
requests  still  in  the  queue. 

Format 

CAN[CEL]  taskname 
Paraaeter 

taskname 

The  name  of  the  task  whose  time-based  initiation  requests  are   to 
be  canceled. 

Example 

VMR>CAN  XKE 

Cancels  all   periodic   rescheduling   and   time-bastd   initiation 
requests  for  task  XKE. 
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CON 

COHPIGUIATXOa 

(K8X-1IH-PL0S  •yateas  only.)  Ose  th«  COHPIOORATION  coaaand  to  display 
syataa  configuration  infomation  on  your  tarainal,  or  to  chang*  tha 
CSR  or  vactor  address  of  a  davica. 

ronMt  1 

CON  DIS [PLAT]  [keyword] [FOR  String] 
Parastatecs 
keyword 

One  of  the  following  keywords: 

COM[TROLLBRS]        CPU 
OIII[TS]  FOL[L] 

FOR  string 

A  parameter  that  restricts  the  display  to  the  devices  matching 
the  specified  string. 

Keywords 

CON[TROLLBRS] 

Displays  every  device  controller  that  is  in  the  current 
configuration. 

UHI [TS] 

Displays  every  device  unit  that  is  in  the  current  system. 
CPU 

Displays  the  CPUs  that  «re  in  the  current  system. 

FOL[L] 

Displays  the  CPUs,  the  controllers,  and  the  device  units  in  the 
current  configuration.  If  you  do  not  specify  any  keyword,  CON 
DISPLAY  defaults  to  FULL.  The  controller's  display  contains 
(from  left  to  right)  the  following  information: 

e  The  controller  name 

e  ffhether  it  is  on  line  or  off  line 

e  The  UNIBUS  Run  Mask  (URM) 

a  The  controller's  CSR  address 

e  The  controller's  starting  vector 

e  The  controller's  priority 
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CON  (Cont.) 


I 


Th«  units  display  contains  (froai  Isft  to  eight)   ths  following 
infomation: 

•  The  logical  d*vic«  nasM 

•  The  physical  device  name   (including  physical  naaes  of 
both  ports  for  dual-ported  devices) 

•  Whether  the  device  is  on  line  or  off  line 
e  A  field  indicating  "driver"  is  loaded 

Bzaaplea 

Single-Processoc  Systeas 


VHR>COHFIG0RATION  DISPLAY  CONTROLLERS 
RHA      OFL     CPA     CSR-176700 
RHB      OFL      CPA      CSR-176300 
RHC      OFL     CPA     CSR- 172040 
KHO      OFL     CPA     CSR-172440 


VBC-254  PRI-5 
VBC-150  PRI-5 
VBC-204  PRI-5 
VEC-224  PRI-5 


TMA 

OFL 

CPA 

CSH- 

170500 

VEC-300  PRI-5 

TSA 

VNR> 

OFL 

CPA 

CSR- 

160100 

VBC-340  PRI-5 

VMR>CON 

D7.S  UNI 

DBO: 

RHAO: 

OVL 

DRIVER 

DBl: 

RHAl: 

OTL 

DRIVER 

DB2: 

RHA2: 

OTL 

DRIVER 

DB3: 

• 

RHA3: 

OTL 

DRIVER 

• 

MLO: 

<VL 

DRIVER 

VTO: 

OTL 

DRIVER 

RDO: 

ONL 

DRIVER 

VMR> 

VHR>COM 

DIS  CPU 

CPA 

VMR>CON  DIS  FUL 

CPA 

RHA      OFL  CPA 

RHB      OFL  CPA 

RHC      OFL  CPA 

RHD      OFL  CPA 


DBO: 
DBl: 
DB2: 
DB3: 


RHAO: 
RHAl: 
RHA2: 
RHA  3: 


CSR-176700 

VEC-254 

PRI-5 

CSR-176300 

VEC-150 

PRI-5 

CSR-172040 

VEC-204 

PRI-5 

CSR-172440 

VEC-224 

PRI-5 

OTL      DRIVER 

OrL      DRIVER 

OFL      DRIVER 

OTL             DRIVER 
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CON  (Cont.) 

NLOt  OrL  DRIVER 

VTOl  OrL  DRIVER 

RDO:  ONL  DRIVER 
VMR> 

Haltipcocesaor  Systeas 

VMR>CONFIGURATION  DISPLAY  CONTROLLERS  FOR  RH 


RHB 

OFL 

CPA 

CSR-176300 

VEC-150 

PRI-5 

RHC 

OFL 

CPA 

CJR=I76700 

VEC-254 

PRI-5 

RHD 

OFL 

CPA 

CSR-I72440 

VEC«224 

PRI-5 

RHH 

OFL 

cpr 

CSR-176700 

VEC-254 

PRI-5 

RHM 

OFL 

CPC 

CSR-176700 

VEC-254 

PRI-5 

RHN 

OFL 

CPC 

CSR-172440 

VEC-224 

PRI-S 

RHR 

OFL 

CPD 

CSR*176300 

VEC-150 

PRI-5 

RHS 

OFL 

CPD 

CSR-176700 

VEC»254 

PRI-5 

VMR>CON 

DIE 

CPU 

CPA 

CPB 

CPC 

CPD 

VMR>CJN 

DIS 

FULL 

CPA 

CPB 

CPC 

CPD 

• 

• 

BSO; 

BSAO: 

BSBO: 

OFL 

DRIVER 

BSl: 

BSCO : 

BSDO: 

BSEO:   BSFO:   OFL 

DRIVER 

DBO:   RHHO:   RHMOi   OFL   DRIVER 


VMR>CON  DIS  FOR  YH 

YHA      OFL  CPA     CSR-160020       VEC-310  PRI-5 

YHB      OFL  CPA     CSR=160040       VEC=320  PRI-5 

YHC      OFL  CPA     CSR=160060       VEC-330  PRI-5 

VMR> 

Format  2 

CON  SET  controller-name  CSR-value 

or 

1 
CON  SET  controller-name  VEC=value 

Parameters 

controller-name 

The  name  of  the  controller  for  which  the  CSR  or  vector  address  is 
to  be  changed. 
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CSR* value 

The  new  CSR  addi-ess  for  the  controller. 
VBC-value 

The  new  vector  address  for  the  controller. 

NOTE 

You  may  enter  only  one  value  per  command 
line  to  the  VMR  CON  SET  connand. 

Bxaaples 

VMR>CON  SET  VHC  CSR=160100 

Sets  the  CSR  address  for  the  third  DH-11  controller  to  160100. 

VMR>CON  SET  YHC  VEC=340 

Sets  the  vector  address  for  the  third  DH-11  controller  to  340. 
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DEV 


DEVICES 

Use  the  DEVICES  command  to  display  the  symbolic  names  of  all  device 
units  or,  optionally,  all  of  a  particular  device  type  defined  in  the 
system  image.  The  device  names  appear  in  a  single  vertical  column.  A 
second  column  contains  any  additional  information  about  each  device. 

Format 


DEV[ICES1     [dd:] 
Parameter 

dd: 


Examples 


The  particular  device  type  to  be  displayed.    If   you   omit   this 
parameter,  the  symbolic  names  of  all  device  units  are  displayed. 


VMR>DEV 

LPO 

:     Loaded 

DBO 

:     Loaded 

DBl 

;    Loaded 

DB2 

:     Loaded 

DDO 

:     Loaded 

DDl 

:    Loaded 

DKO 

:     Loaded 

DKl 

Loaded 

DK2 

:     Loaded 

DK3 

Loaded 

DLO 

:    Loaded 

DLL 

Loaded 

DL2 

Loaded 

DM0 

Loaded 

DM1 

Loaded 

DM2 

Loaded 

DRO 

Loaded 

DRl 

Loaded 

DSO 

Offline   Loaded 

DSl 

Offline   Loaded 

DTO 

Loaded 

DTI- 

Loaded 

DXO- 

Loaded 

DXl: 

Loaded 

EMO: 

Unloaded 

MMO: 

Loaded 

MMl: 

Loaded 

COO! 

TTO: 

TTO: 

Loaded 

TTl: 

Loaded 

TT2; 

Loaded 

TT3: 

Loaded 

TT4: 

Loaded 
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DEV  (Cont.) 


NLO: 

TIO: 

CLO: 

LPO: 

LBO: 

DRO: 

SYO: 

DRO: 

VMR> 

Notes 


Note  that  the  pseudo  device  SY;  is  not  redirected  to  the  booted 
device  until  the  system  is  booted. 

The  following  list  describes  the  messages  that  can  appear  in  the 
second  column.  More  than  one  message  can  appear  on  the  same 
line. 

•  On  RSX-lIM,  OFFLINE  indicates  that,  although  the  systen 
tables  contain  entries  for  the  device,  the  systen  as 
saved  did  not  contain  the  related  device. 

•  On  R8X-I1H-PL0S,  orFLIHB  indicates  that  a  device  has  yet 
to  be  biooght  on  line  by  the  cecon£i9uration  teak.  All 
physical  device*  will  have  this  attribute. 

•  LOADED  indicates  that  the  driver  for  the  device  is 
loadable  and  is  currently  loaded. 

e  UNLOADED  indicates  that  the  driver  for  the  device  is 
loadable  and  is  currently  not  loaded. 

•  A  device  name  in  the  second  column  is  the  device  to  which 
the  corresponding  device  in  the  first  column  has  been 
redirected. 

e  The  absence  of  either  LOADED  or  UNLOADED  in  the  second 
column  indicates  that  the  driver  is  permanently  resident; 
it  is  linked  to  the  Executive. 
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FIX 

FIX-IN-HEMORT 

Use  the  FIX-IN-MEMORY  command  to  load  a  task  oc ,  on  RSX-llM-PLUS 
systems,  a  region  into  its  partition  in  the  system  image.  The  system 
can  service  requests  for  running  the  task  more  quickly  because  the 
task  is  memory-resident  and  does  not  have  to  be  loaded  from  the  disk 
before  it  can  run. 

VMR  can  fix  a  task  in  the  system  image  only  if  the  partition  in  which 
it  is  to  be  fixed  is  available.  (On  RSX-llS  systems,  all  installed 
tasks  must  be  fixed  since  they  cannot  be  loaded  into  the  running 
RSX-llS  system.) 

Fixed  tasks  remain  in  memory  even  after  they  exit.  Therefore,  they  do 
not  have  to  be  reloaded  when  a  request  is  made  to  run  them.  However, 
note  that  reexecuting  fixed  tasks  is  not  always  practical.  If  you 
expect  to  reexecute  a  fixed  task,  you  should  write  it  such  that  it 
initializes  all  impure  data  and  LUN  assignments  at  run  time. 

Only  an  UNFIX  or  REMOVE  command  can  free  the  occupied  partition. 

The  following  restrictions  apply  to  the  fixing  of  tasks: 

•  On  RSX-llM  systems,  checkpointable  tasks  cannot  be  fixed.  On 
RSX-llM-PLUS  systems,  checkpointable  tasks  should  not  be  fixed 
because  fixing  a  checkpointable  task  makes  the  task 
noncheckpointable. 

•  On  RSX-llN-PLOS  systems,  tasks  whose  names  are  in  the  form 
...XXX  and  xxx$$$  cannot  be  fixed  because  that  copy  of  the 
task  is  never  execute<1.   (The  task  is  a  prototype  task.) 

•  Active  tasks  cannot  be  fixed. 

•  A  task  must  be  installed  before  it  can  be  fixed. 
Format 

FIX  taskname [/keyword] 

Parameter 

taskname 

The  task  or  region  that  you  wish  to  fix  in  memory.  If  you  do  not 
specify  a  keyword,  VMR  assumes  that  the  task  is  a  single-user 
task. 

/keyword 

One  of  the  following  keywords  (RSX-llN-PLUS  systems  only) ; 
/DIR 

/Msr 

/REG 
/RON 


10-18 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


FIX  (Cont.) 


Rayword* 
/DIR 


Specifies  that  the  task  to  b*  fixed  is  a  directive  connon. 


Directive  commons   are 
diroctives   instead   of 
addressing  space.   B^ 
they  must  be  instal" 
system  can  be  booted. 


used  to  hold  some  of  the  Executive 
the  directives  being  kept  in  executive 
)  the  commons  contain  Executive  code, 
and  fixed  in  the  system  image  before  the 


The  commons  are  installed  and  fixed  in  the  system  image  by 
commands  in  SYSVHR.CMD  as  part  of  the  system  generation 
procedure.  There  are  two  directive  commons  used  by  RSX-llM-PLUS: 
DIRllM  and  DR211M.  These  coiw.ions  are  installed  and  fixed 
automatically  by  SYSVMR.CMD  during  system  generation.  DIRllH 
must  be  fixed  in  memory  'jefore  any  other  directive  commons  can  be 
fixed.  Other  directive  commons  must  be  fixed  contiguously  to 
DIRllN. 

Directive  commons  are  nonshuf f leable,  that  is,  the  shuffler 
cannot  move  them  around  In  memory  after  they  have  been  fixed. 

To  eliminate  the  directive  commons,  use  the  REMOVE  command. 


/NSF 


Specifies  that  the  task  to  be  fixed  will  be  nonshuf f leable.  The 
shuffler  will  not  be  able  to  move  the  tasks  around  in  memory 
after  the  task  has  been  fixed. 

For  information  .^bout  the  shuffler,  see  Chapter  14. 


/REG 


Specifies  that  the  task  to  be  fixed  is  a  common  region. 


/ROa 

Specifies  that  the  task  to  be  fixed  is  a  multiuser  task,  the 
read-only  portion  of  which  is  to  be  fixed  in  memory.  You  must 
specify  the  entire  task  name. 

Examples 

VMR>F'IX  XKE 

Fixes  task  XKE  in  its  partition. 

VMR>FIX  TTCOM/REG/NSF 

Fixes  resident  common  TTCOM  in  its  partition  and  specifies  that 
the  task  will  be  nonshuff leable. 


VNR>FIX 


EDI/RON 


The  editor  EDI  is  built  as  a  multiuser  task.   This 
fixes  its  read-only  portion  in  its  partition. 


command   line 
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INSTALL 

Use  the  INSTALL  command  to  make  a  specified  task  known  in  the  system 
image  or,  on  RSX-llM  systems,  to  load  a  common  into  a  common 
partition.  An  installed  task  is  dormant  until  the  Executive  receives 
a  request  to  run  it.  The  optional  keywords  either  provide  parameters 
that  were  not  specified  at  task-build  time  or  override  parameters  that 
were  specified. 

When  a  task  is  installed,  VMR  creates  a  Task  Control  Block   (TCB)   for 

the   task   in   a   system   image  table  called  the  System  Task  Directory 

(STD) .   The  task  parameters  contained  in  the  TCB  enable  the  system   to 

ran   the   task  when  requested  to  do  so  by  an  MCR  command,  VMR  command, 

or  a  system  directive.   A  task  cannot  be  run  until  you  install  it. 

A  TCB  contains  the  address  of  the  load-device  Unit  Control  Block  (UCB) 
and  the  logical  block  number  (LBN)  of  the  task  image  file.  Because 
task  image  files  are  contiguous,  the  Executive  can  load  the  task  image 
in  one  transfer  when  an  MCR  command  or  system  directive  requests  an 
installed  task.  (Loading  requires  more  than  one  transfer  if  the  task 
is  larger  than  32K  words.) 

When  VMR  installs  a  task  in  a  virgin  system,  it  stores  the  task's  LBN 
in  the  TCB.  When  you  save  a  system,  the  SAVE  command  places  the  file 
identification,  rather  than  the  file's  LBN,  in  the  TCB.  When  the 
system  is  rebooted,  it  opens  the  task  file  and  stores  the  task's  new 
LBN  in  its  TCB.  If  a  task  has  been  deleted,  the  system  cannot  open 
the  task  file  when  the  system  is  rebooted.  The  system  then 
automatically  removes  the  task's  TCB  from  the  STD. 

When  VMR  installs  a  task  in  a  saved  system  image,  it  stores  the  task's 
file  identification,  rather  than  the  LBN,  in  the  TCB  to  allow  a  reboot 
to  occur  successfully.  It  is  important  that  a  saved  system  image  not 
retain  the  physical  disk  addresses  of  the  installed  tasks  because  the 
Disk  Save  and  Compress  Utility  Program  (DSC)  or  the  Backup  and  Restore 
Utility  (BRU)  can  compress  and  copy  a  disk  containing  a  saved  system, 
thus  moving  the  task  files  to  different  physical  locations.  Because 
the  TCB  entries  contain  task  file  identifications  rather  than  LBNs , 
the  system  can  function  normally  when  it  is  rebooted. 

For act 

INS (TALL]  filespec (/keyword (s) ] 
Paraaaters 
filespec 

A  task  image  file  specification  in  the  form: 

LB: (g,m] filename. type; version 

The  device  specification  must  be  LB:,  the  file  type  defaults   to 
TSK,  and  standard  defaults  ?.pply  to  the  remaining  fields. 
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/keyword (s) 

One   or   more   of    the    following    keywords: 

/AFF=  (utrin] 

/CKP=option 

/CLI=option 

/FIX=option 

/INC=size 

/IOP=option 

/PAR=pname 

/PMD=option 

/PRI=number 

/PRO= (system, owner , group, world] 
Keywords 
/AFF=processor  or  /AFF=urm(s) 


/RON=option 

/ROPAR=pname 

/SEC=option 

/SLV=oDtion 

/TASK=taskname 

/UIC" [group, member ] 

/XHR-option 


(RSX-llM-PLUS  multiprocessor  systems  only.)  The  processor  or 
UNIBUS  Run  Mask  (URM)  affinity  of  the  task.  If  the  latter,  you 
must  specify  at  least  one  URM.  If  you  specify  more  than  one  t'RM, 
you  must  separate  them  by  commas.  The  legal  processor 
specifications  are: 


CPA 
CPB 
CPC 
CPD 


The  legal  URM  specifications  are: 


UBE 
UBF 


UBK 
UBL 


UBP 
UBR 


When  you  specify  the  /AFF  keyword,  the  installed  task   runs   only 
on  the  processor  to  which  the  specified  URMs  are  connected. 


/CKP«option 


The  checkpointability  of  the  task  on  systems  that  support  the 
dynamic  allocation  of  checkpoint  space.  The  options  are  YES  and 
NO.  If  /CKP=YES  (default  for  checkpointable  tasks)  , 
checkpointing  is  enabled  for  the  task.  If  /CKP=NO,  checkpointing 
is  disabled  for  the  task. 

The  /CKP  keyword  overrides  the  /CP  switch  specified  at  task 
build. 

The  task  image  file  need  not  contain  allocated  checkpoint  space. 
The  /CKP-YES  keyword  instructs  the  system  to  allocate  checkpoint 
space  for  the  task,  when  required,  from  a  checkpoint  file. 
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On  RSX-llM  systems,  if  a  task  was  built  with  the  /XH  switch,  the 
/CKP  keyword  is  disabled  for  that  task. 

Default:   /CKP-YES. 

/CLI^option 

Specifies  that  the  task  being  installed  is  a  command  line 
interpreter  (CLI).  The  options  are  YES  and  NO.  You  must  install 
a  CLI  with  the  YES  option  before  you  can  set  a  terminal  to  that 
CLI  (MCR  SET  /CLI)  or  work  with  the  CLI  by  means  of  the  MCR  CLI 
command . 

/FIX=option 

(RSX-llS  systems  only.)  Specifies  whether  memory-resident  tasks 
on  RSX-llS  will  be  fixed  in  memory.  The  options  are  YES  and  NO. 
When  you  specify  /FIX=YES,  the  task  is  both  installed  and  fixed 
in  memory. 

/INC^size 

(Mapped  systems  only.)  The  extension  size;  that  is,  the  number 
of  additional  words  of  address  space  to  be  allocated  to  a  task 
that  runs  in  a  system-controlled  partition.  The  extension  size 
is  usually  expressed  in  octal  but  may  also  be  expressed  in 
decimal  by  appending  a  period  (.).  This  keyword  overrides  the 
Task  Builder's  EXTTSK  or  PAR  options. 

Tasks  such  as  MAC,  TKB,  PIP,  VFY,  and  AT.  (Indirect)  use  the 
space  from  the  end  of  the  task  image  to  the  end  of  their  address 
space  as  dynamic  memory  in  which  to  allocate  symbol  tables  and 
buffers.  The  /INC  keyword  defines  the  number  of  words  in  this 
dynamic  region. 

Default:   the  size  specified  at  task-build  time  or  zero  (0). 

/IOP=option 

Specifies  that  a  privileged  task  can  overmap  the  I/O  page.  The 
options  are  YES  and  NO.  If  /IOP=YES,  INSTALL  assumes  that  the 
task  will  overmap  the  I/O  page  (APR  7)  and,  if  the  task  is  larger 
than  8K  words,  issues  a  warning  message.  If  /lOP^NO,  INSTALL 
?fsumes  that  the  task  does  not  need  to  use  the  I/O  page.  No 
warning  message  is  issued. 

The  /lOP  keyword  complements  the  Task  Builder  /IP  switch. 
Specifying  /IP  informs  INSTALL  that  the  task  ib  intentionally 
overmapping  the  I/O  page. 

Default:   /IOP«YES. 

/PAR-pname 

A  partition  name  that  overrides  the  partition  specified  at 
task-build  time. 

On  RSX-llM  systems,  if  ths  partition  specified  for  the  task  is  a 
user-controlIe<5  pnttitlcn,  the  size  of  the  task  is  extended  to 
the  size  of  the  partition.  Consequently,  if  the  task  is  built 
with  checkpoint  space  allocated  in  the  task  image  file  and  th<<> 
partition  is  extended  (thereby  extending  the  size  of  the  task 
when  it  is  reinstalled) ,  the  allocated  checkpoint  spac«  may  no 
longer  be  large  encigh  to  hold  the  task. 
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If  the  keyword  specifies  a  nonexistent  partition,  VMR  issues  a 
warning  messaqe  and  attempts  to  install  the  task  in  the  GEN 
partition. 

Default:  the  Task  Builder  uses  the  name  GEN.  (See  the  RSX-llM 
or  RSX-llM-PLOS  System  Generation  and  Installation  Guide  for  an 
explanation  of  multiuser  system  defaults.) 

/PMD«option 

Specifies  whether  a  Postmortem  Dump  is  required.  The  options  are 
YES  and  NO.  If  /PMD=YES,  the  system  will  perfo-m  a  Postmortem 
Dump  of  the  task  if  it  aborts  the  task  because  of  an  SST  error 
condition.  If  /PMD=NO  (the  default  from  a  task  build),  the 
system  will  not  perform  a  dump  following  an  SST  abort.  To 
generate  a  dump,  you  must  install  the  Postmortem  Dump  task  PMD... 
in  the  system.  This  keyword  overrides  the  Task  Builder's  /PM 
switch . 

Default:   specified  at  task-build  time. 

/PRI«nuKibev 

The  installed  priority  of  the  task.  The  number  is  the  priority 
at  which  the  task  is  to  be  installed.  The  value  range  is  1 
through  2'j0(10),  where  250  is  the  highest  priority.  Standard 
RSX-llM/M-PLUS  number  conventions  apply  to  this  parameter:  octal 
by  default,  decimal  if  followed  by  a  period. 

Default:   PRI=50(10). 

/PRO- [system, owner , group, world] 

(R8X-11N>PL0S  systems  only.)  The  protection  mask  for  a  common. 
The  square  brackets  are  required  syntax. 

A  task  linked  to  a  conmion  region  with  improper  access  cannot  be 
installed. 

The  user  categories  are  defined  as: 

System 

All  system  tasks  running  under  a  UIC  group  number  less 
than  or  equal  to  10(8). 

Owner 

Tasks  that  run  under  the  same  UIC  as  the  file's  owner. 

Group 

Any  task  that  is  running  under  the  same  UIC  group  as 
the  file's  owner. 


ffcrld 


Any  task   that  does  not   fit   in  one  of  the  above 
categories. 
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Th«  /PRO  ksyword  •■tablish«s  th«  acc«sa  rights  for  ••ch  catagory. 
If  an  accasa  coda  ia  not  apacifiad,  tha  accaas  that  tha  coda 
rapraaants  ia  daniad.   Tha  four  accaaa  codaa  ara: 

a  Raad 

•  Nrita 

•  Bxtand 
a  Dalata 

Dafault:   /PRO- (RlfBD,PWED,RWED, RUED ]  . 

Hota  that  you  cannot  apacify  protection  optiona  for  9.  raad-only 
coanon  region  or  tha  raad-only  portion  of  a  multiuaer  taak. 


/RON-option 


(RSX-llH-PLOS  systems  only.)  Establishes  whether  a  coomon  region 
is  to  be  read-only.  The  options  are  YES  and  NO.  If  /RON-TES, 
the  region  is  installed  aa  read-only.  If  /RON-NO,  the  region  ia 
installed  with  read/write  acceas.  This  keyword  overrides  the 
effect  of  the  /PRO  keyword. 

Default:  /ROM-NO;  the  region  is  installed  with  read/write 
acceas . 

/ROPAR-pnane 

(RSX-llH-PLOS  systMis  only.)  The  read-only  partition  into  which 
the  read-only  portion  of  a  multiuser  task  is  to  be  installed. 
The  pnane  is  the  nana  of  a  read-only  ayatem  partition.  This 
keyword  overrides  the  Task  Builder  options.  If  the  named 
partition  does  not  exist,  VHR  issues  a  warning  measage  and 
attempts  to  install  the  read-only  portion  of  the  task  into  the 
partition  containing  the  read/write  portion  of  the  task. 

Default:   specified  at  task-build  time. 

/SEC'option 

(RSX-llM-PLCS  systems  only.)  Places  the  Task  Control  Block  (TCB) 
for  the  t«sk  being  installed  in  secondary  pool.  The  keyword  ia 
legal  only  for  tasks  whose  namea  are  in  the  form  ...xxx  or 
xxx9$$.  The  options  are  YKS  and  NO.  If  /SEC-NO,  the  TCB  for  the 
task  ia  placed  in  primary  pool  instead  of  secondary  pool. 

Default:   the  TCB  is  placed  in  secondary  pool. 

/SLV=option 

The  task's  slave  status.  The  options  are  YES  and  NO.  If  the 
command  specifies  /SLV=YES,  data  sent  to  t.ie  installed  task  is 
marked  with  the  TI :  of  the  sending  task.  When  the  installed 
task  receives  the  data,  the  system  sets  the  task's  TI:  to  that 
associated  with  the  data.  This  keyword  overrides  the  Task 
Builder's  /SL  switch. 

If  you  specify  /SLV=NO,  the  TI :  of  the  task  does  not  change  when 
the  task  receives  data. 
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on  un-llM-VLVB,  tlM  /8LV  keyword  cannot  b«  as«d  with  tasks  whoa* 
naaas  ara  in  tha  fora  ...xxx.  Thaaa  taaks  ara  prototypa  taaka 
and  cannot  ba  inatallad  as  alavad  tasks. 

Dafaaltt  sp«ci£iad  at  task-build  ti«a. 

/8TNC«option 

(RSX-lin-PLOS  aultiptocsssor  systaas  only.)  Synchroniiaa  taak  uas 
of  a  coaaon.  Ttia  optiona  ara  TM  and  W).  This  kayword  pamits 
ssvaral  taaka  to  ahara  a  coaaion  and  uaa  tha  coawon  foe 
synchronisation.  If  /STHC'TBS  for  two  or  nora  tasks,  only  or«  of 
tha  taaks  can  aiacuta  at  ona  tiaa.  If  ona  of  tha  tacks  bacoaas 
blockad,  th«  othars  coapata  to  asacuta. 

Tha  /STNC  kayword  pravants  inconaiatant  datj  that  occurs  as  tha 
rasult  of  raca  conditions.  For  axaapla,  if  two  tasks  accass  a 
coaaon,  tha  /STNC  kayword  anauras  that  only  ona  task  axacutas  at 
ona  tiaa.  This  pravants  tha  sacond  task  froa  raading  or  writing 
tha  coaaon  whila  tha  first  taak  is  axacuting. 


Dafault:   /STNC-NO. 

/TASK- task name 

The  name  to  be  used  to  install  the  task. 

Default:  the  name  specified  at  task-build  time  or  the  first  six 
characters  of  the  file  name.  (See  the  RSX-llM  or  RSX-llM-PLUS 
System  Generation  and  Installation  Guide  for  an  explanation  oF 
multiuser  system  defaults  . ) 

/UIC* [group, member ) 

The  UIC  for  the  task.  The  square  brackets  are  required  syntax. 
You  can  also  override  the  UIC  with  the  RUN  command. 

The  task  UIC  determines  the  file-protection  class  (system,  owner, 
group,  world)  to  which  a  task  belongs  and  thus  directly 
influences  file  access.  Note  that  file  protection  may  differ 
from  file  to  file. 

Default:  specified  at  task-build  time.  This  default  applies 
only  to  tasks  started  by  a  RUN$  directive  or  a  RUN  command  that 
specifies  a  time  delay  before  run  time.  Tasks  started  by  typing 
the  name  as  a  command  (for  example,  PIP  and  TKB)  run  under  the 
default  UIC  of  the  terminal  from  which  the  command  was  issued. 

/XHR-option 

(R8X-11N-PL0S  systems  only.)  Specifies  that  th«  Executive's  copy 
of  the  task's  header  will  be  in  an  area  external  to  the  system's 
dynaaic  storage  region  (pool) . 

The  options  ace  YES  and  NO.  If  /XHR-TES,  the  task  is  installed 
with  an  external  header.  If  /XHR-HO,  the  task  is  installed  with 
a  reaident  header. 

Nhen  you  specify  /XHR-YES,  the  task's  header  is  not  kept  in  pool. 
Instead,  a  copy  of  the  header  is  placed  in  a  reserved  area 
iaaediataly  below  the  taak  image.   The  Executive  uses  the  copy  of 
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th«  h«ad«r  r•^.h•r  than  th«  actual   haadar.  Nhan  the  task   is 

chackpointadr   tha  system  writes  the  task  image  and  the  copy  of 

the  header  into  the  checkpoint  file.  The  header  in  the  task 
image  is  left  unchanged. 

The  /XHR  keyword  correlates  with  the  /XH  option  for  the  Task 
Builder.  The  default  for  /XHR  and  the  ability  for  a  user  to 
override  the  option  specified  at  task-build  time  depend  on  how 
the  INSTALL  task  was  built  at  system  generation.  See  your  system 
manager  for  this  information. 

Examples 

VMR> INSTALL  SCAN 

Installs  task  SCAN  using  the  default  priority  and  UIC. 

VMR> INSTALL  DM1:  [  I , 111 ) SCAN . TSK ; 4/PRI  =  10  3 

Installs  task  SCAN,  file  type  .TSK,  version  4,  from  device  DM1:, 
group  number  1,  member  number  111,  with  a  priority  of  103(8). 

VMR>INS  MAC/INC=4096./PAR=SYSCTL 

Installs  task  MAC  in  the  partition  SYSCTL  and  increases  the  task 
size  by  4096(10)  words. 
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LOAD 

Use  the  LOAD  conunand  to  load  a  nonresident  device  driver  into  the 
system  image.  LOAD  either  links  a  driver  to  an  already  resident  data 
base  or  makes  a  loadable  data  base  resident.  This  command  eliminates 
the  need  to  link  infrequently  used  device  drivers  permanently  into  the 
Executive . 

Executive  support  of  loadable  device  drivers  is  a  system  generation 
option  on  RSX-llM  but  is  always  included  on  RSX-llM-PLUS. 

Foiaat 

LOA[n]  dd: [/keyword (8) 1 
Paraaeters 
dd: 

A  2-character  ASCII  device  name, 
/keyword (s) 

One  or    two  of  the  following  keywords: 

/CTB-cc(a,b,...]  (RSX-11N-PL08  only) 

/PAR^pname 

/SIZE-psize 
Keywords 
/CTB-cc[a,b,...I  ^^■f""*" 


(RSX-llM-PLUS  systana  only.)  Tha  cc  ia  tha  nana  of  tha 
multidrivac  controllar  (CTB)  that  ahould  ba  uaad  inataad  of 
$ddCTB  in  tha  loadabla  data  baaa.  (a,b,...]  ara  alota  in  tha 
CTB 'a  KRB  tabla  that  ahould  point  at  tha  RRBa  in  tha  loadabla 
data  baaa.  Tha  alota  ara  naaad  A,B,CrD,B,F»H,J,K,L,N,N,P,R,S, 
and  T. 

Tha  /CTB  kayword  ia  uaad  to  load  a  driver  that  rafarencea  a  aplit 
data  baaa.  Rafar  to  tha  RSX-llM-PLUS  Guida  to  Writing  an  I/O 
Drivar  for  mora  information. 


/PAR=pname 


The  partition  into  which  the  driver  is  to  be  loaded.  The  pname 
is  a  partition  name.  The  /PAR  keyword  overrides  the  partition 
specified  at  task-build  time. 


/SIZE'psize 


The  minimum  size  (octal  words)  of  the  partition  into  which  the 
driver  is  to  be  loaded.  The  psize  is  the  partition  size.  VMR 
rounds  psize  up  to  the  next  largest  unit  of  100(8).  Psize  must 
be  less  then  77741. 
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LOA  (Cont.) 

Isaapl** 

VMR>LOAD   MM: 

Loads  th«  TUI6  driver  (MMDRV) . 

VMR>..OA   DK:/PAR»DRVPAR 

Load*  the  RR05  driver  (DKDRV)  into  DRVPAR. 

VMR>LOA   DRt/CTB-RHB 

Loads  th«  RM03  dcivar   (DRDRV) ,  uaing  th«  RHB   Hultidrlvar 
controllac. 


Biotas 


1.  Guidelines  for  building  user-written  loadable  device-driver 
tasks  are  defined  in  the  RSX-llM  and  RSX-llM-PLUS  Guide  to 
Writing  an  I/O  Driver. 

2.  The  LOAD  command  requires  that  a  driver's  .TSK  and  .STB  files 
reside  in  the  same  UFD  and  on  the  same  disk  as  the  system 
image  upon  whic>-  you  are  working.  For  example,  the  following 
command  requirso  that  the  files  DTDRV.TSK  and  DTDRV.STB 
reside  on  SY:   under  the  current  UIC: 

LOA  DT: 

3.  Tht.  LOAD  command  requires  pool  space  as  follows: 

a.  If  the  driver  data  base  is  being  loaded,  the  data  base 
needs  contiguous  pool  space  equal  to  its  size. 

b.  In  a  mapped  system,  each  interrupt  entry  in  t  ..-  driver 
needs  pool  space  for  en  Interrupt  Control  Block  (ICB)  . 

c*  If  the  driver  is  being  loaded  into  a  system-controlled 
partition,  the  Partition  Control  Block  (PCB)  needs  pool 
space. 


• 
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LUN 

LOCICAL  OUT  mmBBM 

Use  the  LUN  coanand  to  display  the  static  LUN  assignaents  for  a 
specified  task.  Static  assignaents  are  those  recorded  in  the  task's 
disk  inage  file  (for  example,  those  assignaients  specified  at 
task-build  tine).  The  display  consists  of  a  list  of  physical  device 
units  in  one  coluan  and  their  corresponding  LUNs  in  an  adjoining 
column. 

Poraat 

LUN(S]  tasknane 
Paraaeter 
tasknane 

The  task  for  %«hich  th«t  LUNs  are  to  be  displayed. 
Bsaaple 


VMR>LUN    XKE 

SYO: 

SYO: 

CLO: 

TT3: 

TT3: 

DKO: 

6 

TT3: 

7 

The  display  shows  static  assignments  tor  LUNs  1  through  7  as 
recorded  in  the  task  image  file  header.  No  other  LUNs  are 
statically  assigned  to  the  task  XKE. 
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PAR 


PARTITIOH  DBPIRITIOR8 

Use  the  PAR  command  to  display  a  description  of  each  memory  partition 
in   the  system   image.    The  display  consists   of   six  columns  that 


speci 


y: 


Partition  name 

Partition  Control  Block  address  (octal) 

Partition  base  address  (octal) 

Partition  size  (octal) 

Partition  type 

Name  of  partition  occupant(s)  —  task,  driver,  coionon ,  and  so 
forth. 


On  RSX-llM-PLOS,  the  syinbols  accompanying  th«  n 
following  Meanings: 

<  >  active  tMsh 

(  ]  in  aeaocy  but  inactive 

*  *   aultiaser  tasks  ^read-only  aections) 

I    I  read-wxite  na«ed  cosMons 

(  )  driver 


have  tffl> 


Tozmat 


PAR[TITI0NS1 
Exaaple  (of  a  saved  system) 

Name    PCB    Base     Size 


PAR/TASK  Name 


VMR>PAR 

SYSPAR 

035720 

G0200300 

00010000 

MAIN 

SPLPAR 

035654 

00210300 

00013000 

MAIN 

DRVPAR 

035610 

00223300 

00140000 

MAIN 

035324 

0C223300 

00003500 

DRIVER 

(DB:) 

035260 

00227000 

00001300 

DRIVER 

(DK:) 

035214 

00230300 

00003600 

DRIVER 

(DR:) 

035150 

00234100 

00001600 

DRIVER 

(DS:) 

035104 

00235700 

00004200 

DRIVER 

(DM:) 

034774 

00246400 

00001300 

DRIVER 

(DT:) 

034730 

00247700 

00001600 

DRIVER 

(DX:) 

034664 

00251500 

00001200 

DRIVER 

(LP:) 

034620 

00252700 

00035500 

RW  COM 

ITTCOM  1 

034534 

00310400 

00020000 

DRIVER 

(TT:) 

034470 

00330400 

00001400 

DRIVER 

(RD:) 

034424 

00332000 

00001300 

DRIVER 

(VT:) 

034360 

00333300 

00003100 

DRIVER 

(CO:) 

034314 

00336400 

00000100 

DRIVER 

(NL:) 

035040 

00336500 

00004400 

DRIVER 

(MM:) 
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PAR  (Cont.) 


LDRPAR  035544  00363300  00003000  MAIN 

033774  00363300  00003000  TASK    <LDR...> 

TSTPAR  035500  00366300  00040000  MAIN 

036454  00366300  00040000  TASK    <SAVT0  > 

SECPOL  035434  00426300  00050000  SEC  POOL 

GEN     035370  00476300  04701500  MAIN 

VMR> 
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REA 

REASSIGN 

Use  the  REASSIGN  coimiiand  to  reassign  a  task's  logical  unit  numbers 
(LUNs)  from  one  physical  device  unit  to  another.  The  reassignments 
affect  only  the  static  assignments  recorded  in  the  task's  disk   image 

The  command  does  not  affect  a  memory-resident  task.  Therefore, 
REASSIGN  has  no  effect  on  the  assignments  for  a  task  that  is  fixed  or 
loaded  in  memory. 

Pomat 

REA(SSIGN]  taskname  lun  new: 
Paraaetcrs 
taskname 

The  name  of  the  tank  for  which  the  LUNs  are  to  be  reassigned, 
lun 

The  logical  unit  number. 
new: 

The  new  device  unit,  which  can  be  a  physical,  logical,  or  pseudo 
device. 

Exaaples 

VMR>REA  LODN  3  TTO: 

Reassigns  LUN  3  of  task  LODN  to  physical  device  TTO:. 

VMR>REA  TEST  3  XX: 

Reassigns  LUN  3  of  task  TEST  to  logical  device  XX:. 
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RED 

REDIRECT 

Ose  the  REDIRECT  conunand  to  redirect  all  I/O  requests  from  one 
physical  device  unit  to  another  physical  device  unit. 

You  cannot  redirect  the  following  device  units: 

•  The  pseudo  device  TI:   (nor  can  a  device  be  redirected  to  TI : ) 

•  An  attached  device 

In  addition,  you  cannot  redirect  a  pseudo  device  to  itself,  nor  can 
you  redirect  a  terminal  to  the  null  device. 

You  can  redirect  a  logged-in  terminal  to  a  device  other  than  a 
terminal  (except  for  the  null  device) ,  but  it  is  not  generally 
advisable  to  do  so  because  terminal  I/O  would  be  written  to  the  device 
and  that  could  destroy  the  boot  block.  If  you  do  redirect  a  terminal 
to  another  type  of  device,  you  should  redirect  the  terminal  to  itself 
before  you  log  out. 

Format 

RED[IRECT]  new:«old: 
Paraaeters 
new: 

The  new  device  unit  to  which  requests  will  be  redirected, 
old: 

The  old  device  unit  from  which  requests  will  be  redirected. 
Biaaples 

VMR>RED  TT3:«TT6: 

Redirects  all  I/O  requests  for  device  TT6:   to  device  TT3:. 

VMR>RED  TT:»LP: 

Redirects  all  I/O  requests  for  device  LPO:   to  device  TTO:. 
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REM 

REMOVE 

Use  the  REMOVE  command  to  delete  a  task  name  or,  on  RSX-llM-PLUS 
systems,  a  region  name  from  the  System  Task  Directory.  Removing  a 
task  from  the  system  image  makes  the  task  unknown  to  the  system.  The 
action  resulting  from  this  command  is  the  complement  of  INSTALL. 

The  REMOVE  command  cannot  remove  an  active  task  from  a  saved  system. 
An  example  of  such  a  task  is  SAV;  an  attempt  to  remove  SAV  from  a 
saved  system  results  in  the  error:   Task  active. 

Poraats 

REM(OVE]  name [/REG] 
Parameters 
name 

The  name  of  the  task,  region,  or  directive  common  to  be  removed. 

Vrbc 

(RSX-llH-PLOS  ayatMis  only.)  Specif !••  that  naae  la  the  naae  of  a 
region. 

You  auat  apecify  thia  keyword  when  reaoving  the  directive 
cnaMiona.   To  reaove  the  coaanona,  uae  the  following  connand  linet 

VMR>RIM  DIRllM/RBG 

Note  that  when  you  renove  DIRllN,  you  ace  reaoving  all  of  the 
directive  eoaaiona  in  the  ayatea. 

Bxaaple 

VMR>REN  SCAN 

Removes  the  task  named  SCAN  from  the  System  Task  Directory.    The 
task  image  file  remains  unaffected. 


Noces 


1.  If  a  task  or  region  that  is  the  object  of  a  REMOVE  command  is 
fixed,  the  command  automatically  unfixes  the  task  from  the 
system  image. 

2,  REMOVE  automatically  cancels  all  time-based  schedule  requests 
for  the  specified  task. 
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REM  (Cont.) 


To  remove  a  command  line  interpreter  (CLI)  task,  you  must 
first  eliminate  the  CPB  for  the  task  with  the  MCR  CLI  /ELIM 
command  on  the  running  system.  Then  use  the  MCR  SAVE  command 
to  update  the  system  image  file,  invoke  VMR,  and  remove  the 
CLI.  However,  it  is  recommended  that  you  work  with  CLIs 
exclusively  with  MCR  on  the  running  system  —  this  includes 
eliminating  and  removing  old  CLIs,  and  installing  and 
initializing  new  ones  —  and  then  save  the  system. 

An  exception  to  this  note  is  the  primary  MCR  task  (MCR...). 
The  CPB  for  this  task  can  never  be  eliminated  and  the  task 
itself  can  only  be  removed  with  VMR. 


• 


• 
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RUN 

ROH 

Use  the  RUN  conaand  to  initiate  the  execution  of   an   installed   task. 
This  cosnand,  which  has  four  formats,  can  cause  a  task  to  be: 

•  Started  one  clock  tick  after  systen  boot 

•  Started  at  a  tisie  incresient  from  the  system  image  time 

•  Started  at  a  time  increment  from  clock  unit  synchronisation 
e  Started  at  an  absolute  time  of  day 

All  of  these  options  are  available  with  or  without  rescheduling. 

On  ISX-llll-PLOS,  you  cannot  run  •  task  using  ths  ...x*x  font  of  tlM^ 
task  naaa,   that  is,  you  cannot  spocify  W3M   ...six.  Ths  ...«»  (and 
xixfM)  focai  is  usod  for  tho  prototypo  copy  oi^  th«  task,  which  is 
novor  ssocutttd. 

Poraat  1 

RUN  taskname  [/keyword (s) ] 

Runs  taskname  one  clock  tick  after  system  boot. 

ParasMtecs 

taskname 

The  1-  through  6-character  task  name  of  the  task  that  you  want 
the  system  to  run. 

/keyword (s) 

One  or  both  of  the  following  keywords: 

/RSI-magu 
/UlC-IuicJ 

Keywords 

/RSI "mag u 

The  reschedule  interval.  The  format  is  the  same  as  that  for 
dtime,  which  is  detailed  under  Format  2.  The  reschedule  interval 
specifies  how  often  you  want  the  system  to  terun  the  task.  Each 
time  the  interval  of  time  you  have  specified  lapses,  the  system 
makes  an  initiation  request  for  the  task.  The  default  is  no 
reschedul ing. 

If  the  magnitude  field  is  equal  to  0,  then  the  reschedule 
interval  is  set  to  1.  Specifying  /RSI-OH  is  the  same  as 
specifying  /RSI-IH. 
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REM  (Cont.) 

3.  To  remove  a  command  line  Interpreter  (CLI)  task,  you  must 
first  eliminate  the  CPB  for  the  task  with  the  MCR  CLI  /ELIM 
command  on  the  running  system.  Then  use  the  MCR  SAVE  command 
to  update  the  system  Image  file,  Invoke  VMR,  and  remove  the 
CLI.  However,  It  Is  recommended  that  you  work  with  CLIs 
exclusively  with  MCR  on  the  running  system  —  this  includes 
eliminating  and  removing  old  CLIs,  and  Installing  and 
Initializing  new  ones  —  and  then  save  the  system. 

An  exception  to  this  note  Is  the  primary  MCR  task  (MCR...). 
The  CPB  for  this  task  can  never  be  eliminated  and  the  task 
Itself  can  only  be  removed  with  VMR. 


» 
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RUN 

RUN 

Use  the  RUN  command  to  initiate  the  execution  of  an   installed   task, 
This  command,  which  has  four  formats,  can  cause  a  task  to  be: 

•  Started  one  clock  tick  after  system  boot 

•  Started  at  a  time  increment  from  the  system  image  time 

•  Started  at  a  time  increment  from  clock  unit  synchronization 

•  Started  at  an  absolute  time  of  day 

All  of  these  options  are  available  with  or  without  rescheduling. 


On  RSX-llM-PLUS,  you  cannot  run  a  task  using  th*  . .  .xxx  form  of  the 
task  name,  that  is,  you  cannot  spacify  RUN  ...xxx.  The  ...xxx  (and 
xxx$$$)  form  is  used  for  the  prototype  copy  of  the  task,  which  is 
never  executed. 

Format  1 

RUN  taskname  [/keyword ( s) ] 

Runs  taskname  one  clock  tick  after  system  boot. 

Parameters 

taskname 

The    1-   to   6-character    task  name  of   the   task      that      you     want      the 
system   to    run. 

/keyword  (s) 

One   or   both  of   the    following    keywords: 


/RSI^magu 
/UIC=[uic] 


Keywords 

/RSI=magu 


The  reschedule  interval.  The  format  is  the  same  as  that  for 
dtime,  which  is  detailed  under  Format  2.  The  reschedule  interval 
specifies  how  often  you  want  the  system  to  rerun  the  task.  Each 
time  the  interval  of  time  you  have  specified  lapses,  the  system 
makes  an  initiation  request  for  the  task.  The  default  is  no 
reschedul  ing  . 

If  the  magnitude  field  is  equal  to  0,  then  the  reschedule 
interval  is  set  to  1.  Specifying  /RSI=OH  is  the  same  as 
specifying   /RSI=1H. 
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/UlC-(uic) 

The  UIC  under  which  the  task  is  requested.  It  determines  which 
files  the  task  can  access.  The  UIC  is  in  the  format  [g,m],  where 
g  and  m  represent  the  group  and  member  numbers,  respectively. 
Legal  group  and  member  numbers  range  from  1  through  377(8).  The 
square  brackets  are  required  syntax. 

Default:   the  UIC  established  for  pseudo  device  CO:. 

Format  2 

RUN  taskname  dtime  [/keyword (s) ] 

Runs  taskname  at  a  time  increment  from  the  system  image  time. 
Parameters 
taskname 

The  1-  through  6-character  task  name. 

dtime 

The  time  at  which  the  task  is  initiated  in  time  units  from  the 
current  system  image  time.   It  has  the  form: 

magu 

mag 

The  magnitude,  which  is  the  number  of  units  to  be  clocked. 
The  magnitude  value  cannot  exceed  24  hours  in  the  specified 
unit  and  is  decimal  by  default. 

u 

Time  units  specified  as  follows: 

T  for  ticks.  A  tick  is  a  clock  interrupt.  The  rate  at  which 
interrupts  occur  depends  on  the  type  of  clock  installed  in 
the  system. 

For  a  line  frequency  clock,  the  tick  rate  is  either  50  or 
60  ticks  per  second,  corresponding  to  the  line  frequency. 

For  a  programmable  clock,  a  maximum  of  1000  ticks  per 
second  is  available.  (The  frequency  is  selected  at  system 
generation. ) 

T  can  be  any  positive  value  up  to  a  maximum  of  15  bits. 

S  for  seconds.  S  can  be  any  positive  value  up  to  a  maximum 
of  15  bits. 

M  for  minutes.  M  can  by  any  positive  value  from  0  through 
1440(10) . 

H  for  hours.  H  can  by  any  positive  value  from  0  through 
24(10)  . 
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RUN  (Cont.) 

/keyword (s) 

One  or  both  of  the  following  keywords: 

/ RSI -mag u 
/UIC-[uicl 

These  keywords  are  described  under  Format  1. 
ro»at  3 

RON  taskname  sync  (dtime) I/keyword (s) ) 

Runs  taskna  le  at  a  time  increment  from  clock  unit 
synchronization. 

The  system  determines  the  task  start-time  by  waiting  for  the 
specified  time  unit  (sync)  to  increment  and  then  waiting  for  the 
specified  time  (dtime)  to  elapse. 

Parameters 

taskname 

The  1-  through  6-character  task  name. 
sync 

The  synchronization  unit.   Permissible  values  are: 

H  -  Synchronize  on  the  next  hour 

M  -  Synchronize  on  the  next  minute 

S  -  Synchronize  on  the  next  second 

T  -  Synchronize  on  the  next  tick 

dtime 

The  value  of  dtime,  if  present,  is  added  to  the  synchronization 
unit  to  produce  the  actual  run  time  for  running  the  task.  The 
format  for  specifying  dtime  is  given  in  Format  2. 

/keyword (s) 

One  or  both  of  the  following  keywords: 

/RSI>magu 
/UIC-[uic] 

These  keywords  are  described  under  Format  1. 
ro»at  4 

RON  taskname  atime  (/keyword (s) ] 
Runs  taskname  at  an  absolute  time  of  day. 
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P«raB«t«ra 

taskname 

The  1-  through  6-character  task  name. 

a  time 

The  absolute  time  of  day  when  this  task  will  be  initiated.  Input 
format  is  hh:mm:ss,  where: 

hh  -  Hours  (decimal  assumed) 
mm  -  Minutes  (decimal  assumed) 
ss  -  Seconds  (decimal  ausumed) 

/keyword (s) 

One  or  both  of  the  following  keywords: 

/RSI-magu 
/UlC-(uic) 

These  keywords  are  described  under  Format  1. 

Bxaaples 

VMR>RUN  XKE  15M 

Runs  task  XKE  15  mir.utes  from  the  current  system  image  time. 

VMR>RON  XKE  15M/RSI-90S/U1C- ( 3 , 1] 

Runs  task  XKE  15  minutes  from  the  current  system  image  time, 
rescheduling  it  every  90  seconds.  The  task  is  running  under  UIC 
(3,1). 


Note 


The  correct  value  to  be  inserted  in  the  clock  queue  for  Formats  2 
through  4  is  computed  from  the  current  value  of  the  system  time 
stored  in  the  system  image.  Thus,  the  system  image  time  must  be 
set  before  any  RUN  requests  are  made  or  they  may  not  occur  at  the 
correct  time  after  the  system  is  booted. 
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SAVE 

Use  the  SAVE  ronunand  to  write  the  image  of  a  system  onto  a  sequential 
medium  in  bootstrappable  format.  With  this  command,  you  can  copy  an 
RSX-llS  or  a  foreign  system  onto  a  tape  or  a  floppy  disk.  You  can 
then  transport  the  tape  or  floppy  to  another  computer  and  bootstrap 
it,  using  a  hardware  bootstrap.  (Refer  to  the  description  of  the  /IM 
switch  in  Section  10.2.) 

On  paper  tape,  system  images  are  created  in  absolute  loader  format  and 
must  be  bootstrapped  with  the  absolute  loader. 

Format 

SAV[E]  ddnn: [label] [/keyword (s) ] 

Parameters 

ddnn: 

The  device  unit  onto  which  the  system  image   is   to  be  written. 
Valid  devices  are  as  follows: 

CT:  Tape  cassette 

DD:  TU58  DECtape  II 

DT:  DECtape 

I  DU:  RX50  flexible  disk/RA60  di8k/RC25  disk  (removable) 

DX:  RXOl  flexible  disk 

DY:  RX02  flexible  disk 

MM:  TE/TU16/TU45/TU77  magnetic  tape 

I  MS:  TS11/TSV05/TU80  magnetic  tape 

MT:  TE/TU10/TS03  magnetic  tape 

PP:  Paper  tape 


label 


The  file  l^bel  name  that  must  be  specified  for  all  secondary 
Media  except  paper  tape.  It  consists  of  from  1  to  12 
alphanumeric  characters. 


Keywords : 

/BOOT«type! 


Specifies  the  type  of  boot  block  being  used  when  the  system  image 
is  saved.  The  options  for  type  are  DX:  (for  RXOls)  and  DY: 
(for  RX02S)  . 

The  keyword  allows  you  to  boot  on  an  RXOl  a  system  that  was  saved 
on  an  RX02  in  single-density  mode  and  vice  versa. 

If  you  do  not  use  /BOOV,  the  boot  block  for  the  type  of  device 
being  used  is  written  to  the  device. 


/DENS=1600 


Specifies  the  bits  per  inch  (bpi)  density  for  the  following 
9-track  magnetic  tapes:  TE16,  TU16,  TU45,  and  TU77.  These  tapes 
use  the  device  mnemonic  MM: 
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VMR>SAV  MTiMYSYS 

In  this  example,   the   system  image   is  written  onto  MT:    in 

bootstrappable  format.   System  changes  made  by  other  VMR  commands 

ate  also  saved  with  the  system  image. 


■otas 


1.  When  you  save  RSX-llS  systems  on  paper  tape  and  you  do  not 
apply  the  /IM  switch  to  the  system's  file  name  (refer  to 
Section  10.2  for  a  description  of  the  /IM  switch),  the  last 
1000(8)  bytes  of  the  system  image  are  not  written  out.  This 
allows  space  to  accommodate  the  absolute  loader.  When  you 
specify  the  /IM  switch  with  the  system's  file  name,  the 
entire  system  image  is  written  to  paper  tape.  In  this  case, 
it  is  your  responsibility  to  ensure  that  the  system  image  is 
not  so  large  that  it  overlays  the  absolute  loader. 

2.  When  you  save  a  system  on  paper  tape,  contiguous  bloclcs  that 
contain  only  zero  and  that  begin  on  a  32-word  address  are 
compressed  into  a  2-word  descriptor.  This  compression 
significantly  reduces  both  the  amount  of  paper  tape  required 
and  the  time  expended  to  create  the  tape  and  to  read  it  into 
memory.  After  the  entire  image  has  been  loaded  into  memory, 
a  short  routine  zeroes  the  appropriate  blocks  of  memory 
before  passing  control  to  the  bootstrapped  system. 

3.  When  you  bootstrap  systems  on  media  other  than  paper  tape, 
regardless  of  the  size  of  the  system  image,  the  last  1000(8) 
bytes  of  physical  memory  are  not  copied  to  accommodate  the 
bootstrap. 

4.  Systems  saved  on  a  TE/TU10/TS03  9-traclc  magnetic  tape  drive 
can  be  booted  from  a  TE/TU16  drive  and  vice  versa. 

5.  When  you  specify  the  /IM  switch  with  the  system  file 
specification,  the  SAVE  command  always  uses  a  bootstrap  that 
does  not  enable  memory  management. 

6.  On  RSX-llN,  the  maximum  memory  size  of  a  system  is  124K 
words.  The  SAVE  command  imposes  maximum  sizes  on  saved 
images  of  mapped  systems  for  certain  devices.  If  a  mapped 
system  is  saved  and  its  memory  size  is  greater  than  the 
maximum  size  imposed  by  the  SAVE  command  for  the  specified 
device,  only  the  amount  of  memory  equal  to  the  maximum  size 
(starting  at  physical  location  0)  is  saved;   no  diagnostic 

message  is  issued. 

The  devices  for  which  the  SAVE  command  imposes  a  maximum  size 
on  saved  system  images  are: 

Paper  tape  punch  (PP:)  28K  words 

Cassette  tape  (CT:)  28K  words 

RXOl  flexible  di<sk  (DX:)  123K  words 

RX02  flexible  disk  (DY:)  123K  words 
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7.  None  of  th«  bootstraps  require  that  a  target  RSX-llS  system 
have  a  driver  for  the  bootstrap  device. 

8.  Unless  you  specify  /DENS-1600,  when  you  save  a  system  image 
to  a  magnetic  tape  drive  that  supports  multiple  densities, 
the  drive  is  forced  to  800  bpi  before  the  SAVR  operation  is 
started. 


10-42 


VIRTOAL  NOBITOR  COHSOLB  ROOTIIIB  (VHR) 


SET 


SET 

Use  the  SET  command  to  alter  a  number  of  system-wide  characteristics. 
The  following  list  describes  the.  available  options.  The  SET  command 
allows  you  to: 

•  Display  the  status  (determined  by  the  keyword  specified)  for 
all  terminals 

•  Establish  device  characteristics  for  any  device  in  the  system 

•  Establish  the  default  UIC  for  any  terminal  in  the  system 

•  Establish  the  system  UIC  used  by  the  LOAD  command  and  the 
install-run-remove  option  of  the  MCR  RUN  command 

•  Set  the  status  of  any  terminal  in  the  system 

•  Create  and  eliminate  partitions 

•  Add  space  to  the  system  dynamic  memory 

•  Enable  write  checking  and  seek  optimization  on  devices  that 
support  it 

Improper  use  of  the  SET  command  can  result  in  a  situation  in  which  the 
system  will  not  accept  privileged  user  input.  The  following 
situations  should  be  avoided: 

•  The  system  does  not  have  any  nonslaved,  privileged  terminals. 
This  is  unacceptable  because  nonpr ivi leged  terminals  cannot 
enter  privileged  commands  and  slaved  terminals  cannot  enter 
unsolicited  input  to  MCR.  See  the  description  of  the  /SLAVE 
keyword . 

•  The  buffer  length  of  any  nonslaved,  privileged  terminal  is 
shorter  than  14  bytes  on  RSX-llM  and  shorter  than  2  bytes  on 
RSX-llM-PLUS.  In  this  case,  the  terminal  buffer  is  too  small 
to  enter  many  important  commands  required  either  to  continue 
system  operation  or  alter  the  status  of  other  terminals.  See 
the  description  of  the  /BUF  keyword. 

On  RSX-llM,  a  number  of  SET  conmand  options  (for  example,  /CRT, 
/ESCSEQ,  /LOWER,  and  /WCHK)  require  Executive  features  that  must  be 
included  at  system  generation.  If  you  specify  an  option  that  has  not 
been  generated  into  the  system  image,  the  SET  command  has  no  effect 
and  results  in  an  error  message. 

Also,  some  of  the  keywords  are  only  supported  with  the  full-duplex 
terminal  driver.  The  full-duplex  terminal  driver  is  a  system 
generation  option  in  RSX-llM  systems  but  is  always  included  in 
RSX-llM-PLUS  systems.  Note  that  if  you  select  the  full-duplex  driver 
on  RSX-llM,  you  must  also  select  the  get/set  multiple  characteristics 
options  to  set  or  display  any  terminal-related  characteristics. 

VMR  permits  only  one  keyword  per  command  line.  You  can  prefix  most 
keywords  by  NO  to  negate  or  disable  the  function  of  the  keyword.  VMR 
returns  a  syntax  error  message  when  NO  precedes  a  keyword  for  which  it 
is  illegal. 
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Examples  of  using  the  SET  coimnand   follow  the  description  of   the 
keywords. 

Format 

SET  /keyword-value 

Paraaeter 

/keyword-value 

One  of  the  keywords  listed   in   Table   10-1.    The   keywords  are 
described  in  alphabetical  order  following  the  table. 

Table  10-1 
SET  Keywords 


Type 

Keywords 

Device 
Characteristics 

/ABAUD(-ttnn:] 
/BRO[-ttnn:] 

/BUF-ddnn: [size] 

/CRT[-ttnn:] 

/EBC[-ttnn: ] 

/ECHO(»ttnn:] 

/ESCSEQ(-ttnn: J 

/FDX[-ttnn:] 

/FORMFEED(-ttnn:] 

/HFlLL-ttnn: (value) 

/HHTI«ttnn:) 

/LINES»ddnn: (value) 

/LOWER(»ttnn: ) 

/OPT ("ddnn  ropttyp) 

/PRIV("ttnn:) 

/PUB(-ddnn:] 

/REMOTE («ttnn: (baud) ) 

/RPA(»ttnn:) 

/SLAVE(»ttnn: ] 

/SPEED«ttnn: (recv:xmit] 

(continued  on  next  page) 
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Type 

Keywords 

Device 

Characteristics 

(Cont.) 

/TERM-ttnn: [type] 
/TYPEAH)!AD(-ttnn:  [size]  ] 
/UIC(-[uic] l:ttnn:) ] 
/VFlLL-[ttnn:) 
/WCHK[-ddnn:l 
/WRAP(-ttnn:] 

Enable/Disable 
Login 

/LOGON 

Library  or 
System  UICs 

/LIBUICl»(uic] 1 
/NETUIC(-(uicl 1 
/SYSUIC(-[uic] 1 

Memory 
Allocation 
(see  notes 
before 
examples) 

/AFF»(UNIBUS-mask] 

/BOT»=pname:  value 

/MAIN=pnameI :base : size: type] 

/NOMAIN»pname 

/MAXEXTf^size] 

/PAR="pname[  :base  :size  [  :  type)  ) 

/NOPAR=pname 

/POOL(=top] 

/POOLSIZE(=valuel 

/SEC POL 

/SUB=mname:pname[ : base: size) 

/NOSUB=mname : pname 

/TOP=pnarae: value 

Pool 
Monitor  Task 

/PLCTL[=[high]  (:(low]  l:Ifrsiz]  ( :basep) ) )] 

System 
Tuning 

/RNDC[=nn) 
/RNDH[=nn) 
/RNDL[=nn) 
/SWPC(»nn] 

/SWPR[=nn) 
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K«y«erd«t 

/ABAOD(-ttnn;] 

(Pull-duplex  terminal  driver  only.)  Enables  autobaud  detection 
for  the  remote  dial-up  line  for  the  specified  terminal.  The 
terminal  driver  samples  the  line's  first  input  character,  tries 
to  determine  the  incoming  baud  rate,  and  sets  the  interface  speed 
accordingly. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  with  autobaud  detection. 

/NOABAUDl-ttnn:] 

(Full-duplex  terminal  driver  only.)  Disables  autobaud  detection 
for  the  specified  terminal.  The  terminal  driver  does  not  attempt 
to  determine  the  incoming  baud  rate  for  the  remote  dial-up  line. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  autobaud  detection. 

/AFF- [UNIBUS-run-mask , . . . ) 

(RSX-IIM-PLUS  multiprocessor  systems  only.)  Specifies  which  I/O 
page  will  contain  the  device  partition.  The  keyword  is  required 
for  creating  dpvice  partitions  on  the  system. 

UNIBUS-run-mask 

A  3-lettet  name  of  the  UNIBUS  Run  Mask  (URM)  with  which  the 
device  partition  is  associated.  There  is  one  URM  for  each 
processor,  as  follows: 

CPA 
CPB 

CPC 
CPD 

There  are  also  up  to  12  URMs  for  the  switched  UNIBUS  runs, 
as  f ol lows : 


UBE 

UBK 

UBP 

UBF 

UBL 

UBR 

UBH 

UBM 

UBS 

UBJ 

UBN 

UBT 

You  must  specify  at  least  on'.-  URM.   If  you  specify  more  than   one 
URM,  you  must  separate  them  by  commas. 

You  must  enclose  the  URM  specification  in  brackets. 

For  example,  to  create  a  device  partition  that  is  mapped  to  CPA' s 
1/0  page,  enter  the  following  command: 

SET  /PAR-DEVP: 177600 : 200 : DEV/AFF= [CPA] 
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/BOT-pname: value 

Directs  VMR  to  move  the  bottom  boundary  of  the  specified 
system-controlled  partition  up  or  down  the  amount  indicated  by 
the  value  parameter.  The  keyword  modifies  the  bottom  boundary  of 
a  partition  even  thouqh  it  has  tasks  installed  in  it.  If  you 
modify  the  partition  uo  that  it  becomes  too  small  to  hold  the 
tasks  installed  in  it,  VMR  displays  a  warning  message,  but  it 
will  modify  the    'tition  anyway. 

pname 

The  1-  to  6-character  alphanumeric  partition  name, 
value 

The  number  of  64-byte  blocks. 

The   value   parameter   can  be   supplied   in   five   formats: 
+value,  -''alue,  value,  +*  or  *,  and  -*. 

lvalue 

Moves  the  bottom  boundary  up  by  the  specified  amount. 
Moving  the  bTttom  boundary  up  makes  the  partition 
smaller  . 


NOTE 

You  can  supply  the  value  in  the  same  units  as 
those  of  the  base  and  size  parameters  for  the 
/PAR  keyword. 


• 


■value 


Moves  the  bottom  boundary  down  by  the  specified  amount. 
Moving  the  bottom  boundary  down  makes  the  partition 
larger . 


value 


Establishes  the   total   partition   size  eqoal   to   the 
specified  value  by  moving  the  bottom  boundarv. 


+*  or 


.* 


Moves  the  bottom  t^oundary  up  as  far  as  possible.  Note 
that  using  this  format  will  cause  the  bottom  boundary 
to  move  up  to  the  bottom  of  the  first  fixed  task  or 
fixed  driver  loaded  into  the  partition  at  the  time  the 
/BOT  keyword  is  executed.  If  there  is  nothing  loaded 
into  the  partition,  it  assumes  a  size  of  one  64-byte 
block. 


Koves  the  bottom  boundary  down  as  far  as  possible. 
Using  this  format  will  cause  the  bottom  boundary  of  the 
partition  to  move  down  to  the  top  boundary  of  the 
partitiot:  below  it,  or  to  the  top  of  the  Executive  pool 
if  the  partition  is  the  lowest  partition  in  memory. 
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/BRO(-ttnn:l 

Enablos  the  broadcast  option  for  the  specified  terminal.  The 
terminal  can  receive  messages  sent  from  other  terminals  with  the 
MCR  BROADCAST  command. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  can  receive  messages. 

The  /BRO  Keyvc.rd  is  valid  only  on  systems  with  multi-CLI  support. 

/N0BRO(»ttnn:l 

Disables  the  broadcast  option  tor  the  specified  terminal.  The 
terminal  cannot  receive  messages  sent  from  other  terminals. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  cannot  receive  messages. 

The  /NOBRO  keyword  is  valid  only  on  systems  with  multi-CLI 
support . 

/BUF-ddnn: [size] 

Sets  the  default  buffer  size  of  the  specified  device.  The  size 
must  be  greater  than  zero  and  less  than  or  equal  to  255(10)  (for 
a  terminal,  the  buffer  size  must  be  greater  than  or  equal  to  15 
decimal).  The  /BUF  keyword  is  particularly  useful  for  defining 
line  printer  width  (80  or  132  columns) . 

When  you  omit  the  size  specification,  VMR  displays  the  current 
buffer  size  of  the  device. 

/CRT[«ttnn:] 

Defines  the  specified  terminal  as  a  cathode  ray  tube  (CRT) 
terminal  and  enables  the  backwards  deletion  option.  When  the 
backwards  deletion  option  is  enabled,  pressing  the  RUBOUT  or 
DELETE  key  moves  the  printing  position  one  space  to  the  left  and 
erases  any  character  displayed  in  that  position. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  are  defined  as  CRTs. 

/NOCRT[-ttnn:) 

Deletes  the  CRT  status  of  the  specified  terminal  and  disables  the 
backwards  deletion  option. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  are  not  defined  as  CRTs. 

/EBC[-ttnn:] 

(Full-duplex  terminal  driver  only.)  Enables  the  8-bit  character 
option.  The  terminal  drive*  passes  all  eight  bits  of  the  input 
characters  to  the  specified  'cf,rminal. 

When  you  omit  the  terminal  specification,  VMl  displays  all  the 
terminals  that  have  the-  8-bit  character  option   -abled. 
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/NOEBC(-ttnr. ; 


(Full-duplex  terminal  driver  only.)  Disables  the  8-bit  character 
option.  The  terminal  driver  strips  off  the  parity  bits  of  the 
input  characters  before  passing  them  to  the  device. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  the  8-bit  character  option  enabled. 

/rCHO(-ttnn:) 

Enables  the  echo  option.  The  terminal  driver  displays  each 
character  that  is  typed  on  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
termirals  that  have  the  echo  option  enabled. 

/NOECHO[-ttnn:] 

Disables  the  echo  option.  The  terminal  driver  does  not  display 
the  characters  that  are  typed  on  the  specified  teminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  echo  option  disabled, 

/ESCSEQ(-ttnn:l 

Enables  the  recognition  of  escape  sequences  from  the  specified 
terminal.  The  terminal  driver  treats  the  ESC  character  as  the 
beginning  of  an  escape  sequence  rather  than  as  a  line  terminator. 
(See  the  RSX-llM/M-PLOS  I/O  Drivers  Reference  Manual  for  further 
information  about  escape  sequences.) 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  recognize  escape  sequences. 

/NOESCSEQi-ttnn:] 

Disables  the  recognition  of  escape  sequences  at  the  specified 
terminal . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  support  the  recognition  of  escape 
sequences . 

/FDX[-ttnn:l 

(Full-duplex  terminal  driver  only.)  Enables  the  full-duplex 
option.  The  terminal  driver  accepts  input  from  the  specified 
terminal  while  simultaneously  outputting  to  it. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  full-duplex  option  enabled. 

/NOFDX[-ttnn:] 

(Full-duplex  terminal  driver  only.)  Disables  the  full-duplex 
option.  The  terminal  driver  will  not  process  input  and  output 
from  the  specified  terminal  simultaneously. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  the  full-duplex  option  enabled. 

10-49 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 

SET  (Cont.) 

/FORMFEED (-ttnn:] 

Indicates  that  the  specified  terminal  has  a  hardware  form  feed. 

When  you  omit  the  terminal  specification,  VMM  displays  all  the 
terminals  that  have  hardware  form  feeds. 

/NOFORMFEED(-ttnn:] 

Indicates  that  the  specified  terminal  will  not  have  a  hardware 
form  feed. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  do  not  have  hardware  form  feeds. 

/HFILL»ttnn: (value) 

(Full-duplex  terminal  driver  only.)  Specifies  the  number  cf  fill 
characters  (value)  that  the  terminal  driver  is  to  place  after  a 
carriage  return  when  outputting  to  the  specified  terminal.  The 
value  is  a  number  from  0  through  7. 

When  you  omit  the  value  parameter,  VMR  displays  the  number  of 
fill  characters  currently  being  output  by  the  terminal  driver  to 
the  specified  terminal. 

/HHT(-ttnn:) 

(Full-duplex  terminal  driver  only.)  Indicates  that  the  specified 
terminal  has  a  hardware  horizontal  tab. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  a  hardware  horizontal  tab. 

/NOHHT[.ttnn:) 

(Full-duplex  terminal  driver  only.)  Indicates  that  the  specified 
terminal  will  not  have  a  hardware  horizontal  tab. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  a  hardware  horizontal  tab. 

7LIB0IC(-(uic]] 

(RSX-llM-PLUS  syateiBS  only.)  Disrects  the  INSTALL  conMand  to 
search  the  specified  OIC  in  response  to  a  RON  $file  or  INS  $file 
coMiand  when  the  file  is  not  in  the  system  UIC. 

The  OIC  is  in  the  f onset  Ig,BiJ,  where  s  and  m  are  octal  numbers 
"""  1  through  377(8)  that  represent  a  group  and  member  number, 
respectively.  The  square  brackets  are  required  syntax.  The 
default  LIBOIC  is  (3,54]. 

Hhen  you  omit  the  OIC  specification,  VMR  displays  the  current 
library  UIC. 


10-50 


VIRTUAL  MONITOR  CONSOLE  ROOTINB  (VMR) 

SET  (Cont.) 


/LINES-ddnn: [value] 

(Pull-duplex  terminal  driver  only.)  Establishes  the  number  of 
lines  per  page  on  the  specified  device.  The  value  is  a  number 
from  1  through  2S5(10).  If  you  specify  a  number  that  is  lanjer 
than  the  number  of  lines  per  page  possible  for  a  given  device, 
VMR  defaults  to  the  largest  number  possible  for  that  device. 

When  you  omit  the  value  parameter,  VMR  displays  the  lines  per 
page  for  the  specified  device. 


/LOGON 


Enables  logging  in  on  terminals  in  a  multiuser  protection  system. 
'See  /NOLOGON  for  more  information.) 

/NOLOGON 

Disables  logging  in  on  terminals  in  a  multiuser  protection 
system.  /LOGON  and  /NOLOGON  clear  and  set  a  flag  checked  by  the 
HELLO  command  when  a  user  attempts  to  log  in  on  a  terminal. 
/NOLOGON  provides  a  means  of  preventing  users  from  accessing  the 
system  during  such  activities  as  system  maintenance  or  account 
file  maintenance. 

/LOWER("ttnn:l 

Specifies  that  lowercase  characters  are  not  to  be  converted  to 
uppercase  when  they  are  received  from  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  for  which  lowercase  characters  ace  not  converted. 

/NOLOWER(-ttnn:l 

Resets  the  terminal  characteristics  of  the  specified  terminal  so 
that  lowercase  characters  received  on  input  are  automatically 
converted  to  uppercase  and  echoed  as  uppercase. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  for  which  conversion  to  uppercase  is  specified. 

/HAIN-pnaa«[ :bas«:sii«:type] 

(RSX-IIH  systMis  only.)  Establish**  a  aai.>  partition. 

pnaae 

The  1-  to  6-chacactac  alphanuaeric  partition  naaa. 

baa* 

The  physical  bas*  addr*ss  of  th*  partition  sp*cifi*d  as  a 
nuab*r  of  64-byt*  blocks. 


sis* 


Th*  sis*  of  th*  partition  sp*cifi*d  as  a  nunbar  of  64-byt* 
blocks.  Th*  naxisiuai  sis*  is  0  to  1920. K  words  for  a  task, 
coooion,  or  main  partition. 
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type 

SYS  for  a  main  partition,  DEV  for  a  cominon  partition  that 
naps  the  device  registers,  COM  for  a  common  partition,  or 
TASK  for  a  task  partition. 

Main  partitions  are  allocated  for  user  tasks  and  loadable 
drivers. 

Device  partitions  are  allocated  for  device  commons  that  are  used 
by  tasks  to  access  the  device  registers  on  the  I/O  page. 

You  can  enter  base  and  size  in  any  of  che  following  formats t 

roraat       Calculated  Valoe 

nnnn  Octal  (nnnn*100) 

nnnn.  Decimal  (nnnn.*64.) 

nnnK  Octal  K  (nnn*4000) 

nnn.K  Decimal  K  (nnn.*2048.) 

where  nnnn  is  a  number  to  which  a  multiplication  factor  is 
applied  to  determine  the  value  used.  Valid  ranges  of  calculated 
values  are: 

Octal  0<-base<177777  0<size<2000 

Decimal  0.<-base<65535  0.<size<1024. 

Octal  K  0R<-base<3777K  0K<8ize<40K 

Decimal  K  O.K<-ba8e<2047.K  O.K<size<32.K 

For  system-controlled  partitions,  size  may  range  from  0  to  1920. K 
or  any  valid  representation  of  these  limits. 

You  can  specify  the  base   address  of  a  partition   through  a 

wildcard  (*)  for  TASK  or  SYS  partitions  in  a  mapped  system.   When 

you  specify  a  wildcard  (*),  VMR  creates  a  partition  at  the  lowest 

address  possible  for  a  partition  of  the  size  you  have  specified. 

You  can  also  specify  the  size  of  a  partition  through  a  wildcard 
(*)  for  SYS  partitions.  When  you  specify  the  wildcard  (*) ,  VMR 
creates  the  largest  possible  partition  starting  at  the  base 
address  you  have  specified  in  the  base  parameter. 

When  you  specify  wildcards  for  both  the  base  and  size,  VMR  will 
create  a  partition  that  will  completely  fill  the  first  gap  in  the 
existing  partition  layout. 

If  you  do  not  specify  base,  size,  or  type,  VMR  displays  the 
values  of  these  parameters  for  the  named  partition.  If  the  named 
partition  is  a  main  task-controlled  partition,  VMR  also  displays 
the  parameters  of  all  its  subpartitions. 

/MONAIN-pnane 

Eliminates  a  named  main  partition  from  the  system.  The  partition 
you  specify  is  eliminated  from  the  list  of  partitions  and  the 
system.  If  any  tasks  or  commons  are  installed  in  or  attached  to 
the  partition,  the  partition  is  not  eliminated  and  VMR  generates 
an  error  message. 
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/MAXEXT(-8izel 

Establishes  the  maximuin  siz*  to  which  a  task  can  extend  itself 
beyond  its  mapped  array  area  by  means  of  the  EXTEND  TASK 
directive.  (See  the  RSX-1 IM/M-PLUS  Executive  Reference  Manual 
for  a  description  of  the  directive.)  The  size  is  given  in  units 
of  32(10)-word  blocks.  The  maximum  size  allowed  is  1777(B)  for 
systems  without  PLAS  and  177777(8)  for  systems  with  PLAS. 

You  can  specify  size  in  the  following  five  formats: 

Specified  Resulting 

Size  fize 

n  (n*100)  octal 

n.  (n*64.)  decimal 

nK  (n*4000)  octal 

n.K  (n*2048.)  decimal 

•  1777(8)  maximum  for  systems  without  PLAS ; 

177777(8)  maximum  for  systems  with  PLAS 

When  you  omit  the  size  specification,  VMR  displays  the  current 
maximum  extension  size  in  100(8)-byte  units. 

The  /MAXEXT  keyword  is  valid  only  on  mapped  RSX-llM  systems  that 
have  selected  the  EXTEND  TASK  directive  option  during  system 
generation  and  on  all  RSX-llM-PLUS  systems.  However,  you  can  use 
both  the  unmapped  and  mapped  versions  of  VMR  to  establish  the 
maximum  extension  size  for  tasks. 

/NETUIC["(uic) ) 

Specifies  the  UIC  in  which  all  DECnet -related  tasks  are  stored. 
The  keyword  applies  only  to  systems  that  selected  the  external 
communication  products  option  during  system  generation.  The  UIC 
is  in  the  format  Ig,m),  where  g  and  m  are  octal  numbers  from  1  to 
377(8)  that  represent  a  group  and  member  number,  respectively. 
The  square  brackets  are  required  syntax. 

When  you  omit  the  UlC  specification,  VMR  displays  the  current 
network  UIC. 

/OPT [ addnn : opt  typ ] 

(RSX-llM-PLUS  •ystems  only.)  Bnablea  disk  I/O  queue  optimization 
foe  the  specified  device.  Fol  more  information  on  optimization 
and  on  the  algorithm  (opttyp)  parameter  for  this  keyword >  see 
CAapter  16. 


idnn  t 


The  device  that  will  use  I/O  queue  optimisaici-n).  Legal 
devices  are  DB:-,  DL:-,  DM:-,  and  DR:-typ4  devices.  When 
you  do  not  specify  a  device,  VMR  displays  all  the  devices 
that  use  optimisation. 


10-53 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


SET  (Cont.) 


opttyp 

Th*  algorithm  for  optJmiiation.   The  algorithms  ar«i 

NEAR [EST] 

ELEV[ATOR) 

CSCAN 

The  default  algorithm  set  at  ayatam  generation  ia  NEAR. 

/NOOPTl-ddnn:) 

(RSX-llH-PLUS  ayatema  only.)  Diaablea  disk  I/O  queue  optimiiati<}n 
for  the  apecified  device. 

vrhen  you  omit  the  device   apecif ication,   VMR  diaplaya  all   the 
devices  that  do  not  uae  I/O  queue  optimisation. 

/PAR«pname( :baae:aiz^( :type] ] 

(RSX-llM-PLUS  ayatema  only.)  Eatabliahea  a  partition. 

pname 

The  1-  through  6-character  alphanumeric  partition  name. 

baae 

The  phyaical  baae  addreaa  of  the  partition  apecified   aa  a 
number  of  64-byte  blocka  or  aa  a  wildcard  (*). 


aize 


The  sise  of  the  partition,  apecified  as  a  number  of  64-byte 
blocks  or  aa  a  wildcard  (*).  The  maximum  aize  ia  0  to 
1920. K  worda  for  a  taak,  common,  or  main  partition. 

typa 

SYS  for  a  laain  partit^.on,  SECPOL  for  a  secondary  pool 
partition,  DEV  for  a  common  partition  that  maps  the  device 
registers,  or  CPU  for  ^PU  partitiona. 

Main  partitions  are  allocated  for  user  tasks  and  loadable 
drivers. 

Pool  par.titions  are  allocated  for  secondary  pool. 

Device  partitiona  are  allocated  for  device  commons  that  tasks  use 
to  access  the  device  registers  on  the  I/O  page.  Note  that 
creating  a  device  partition  automatically  creates  a  main 
partition  named  10  PAR,  which  spana  the  entire  I/O  page.  The 
partition  you  specify  with  the  /PAR  keyword  then  beconea  n 
subpartition  of  10  PAR.  On  niultiproces^or  systems,  you  must  use 
the  /AFF  (affinity)  keyword  to  specify  which  I/O  page  contains 
the  device  partition. 

CPU  partitions  are  allocated  on  multiprocessor  systems  to  store 
vectors  for  all  the  devices  aasociated  with  the  particular 
procesaor . 

Partition  type  is  an  optional  parameter.  If  you  do  not  specify 
it,  SYS  is  the  default. 


10-54 


• 


# 


ViRTOAL  HOMiTOR  COBSOLE  ROOTIHE  (VWR) 


SET  (Cont.) 


Too  can  •nt^r  baa*  and  ait*  in  any  of  tha  fol lowing  foraata: 
Poraat        Calcalatad  Vain* 


nnnn  Octal  (nnnn*100) 

nnnn.  Daciaal  (nnnn.* 64.) 

nnnK  Octal  K  (nnn*4000) 

nnn.K  Daciaal  K  (nnn.*2048.) 

wtMca  nnnn  la  a  nuabar  to  which  a  aultlplication  factor  is 
•ppliad  to  dataraina  tha  valua  uaad. 

Pot  ST8  partitiona,  aisa  can  range  froa  0  to  1920. K  or  any  valid 
rapraaantation  of  thaaa  liaita.  For  axaapla,  tha  following 
inputa  for  aisa  allocate  a  2048 (10) -byte  partition: 

40 
32. 
IR 
l.K 

Tou  can  alao  specify  the  baae  address  of  a  partition  with  a 
wildcard  (*) .  When  you  apecify  a  wildcard  (*) ,  VHR  creates  a 
partition  at  the  loweat  address  possible  for  a  partition  of  the 
size  you  have  specified. 

Tou  can  alao  specify  the  sise  of  a  partition  with  a  trildcard  (*). 
When  you  specify  the  wildcard  (•) ,  VMR  creates  the  largest 
possible  partition  starting  at  the  baae  address  you  have 
specified  in  the  base  parameter.  When  you  specify  a  wildcard  for 
a  CPU  partition,  VMR  creates  a  partition  of  size  (n-l)*4K,  where 
n  is  the  nuaber  of  processors  specified  during  SYSGEN. 

When  you  specify  wildcards  for  both  the  base  and  aize,  VMR 
creates  a  partition  that  completely  fills  the  first  gap  in  the 
existing  partition  layout. 

If  you  do  not  specify  base,  size,  or  type,  VMR  displays  the 
values  of  these  parameters  for  the  named  partition.  If  the  named 
partition  is  a  main  partition,  VMR  also  displays  the  parameters 
of  all  its  subpartitions. 

When  you  are  establishing  base  and  size  for  a  CPU  partition,  note 
that  the  entire  CPU  partition  must  exist  below  124K. 

/NOPAR'pname 

(RSX-llM-PLUS  systems  only.)  Eliminates  a  named  partition  from 
the  system.  The  partition  you  specify  is  eliminated  from  the 
list  of  partitions  and  the  system.  If  any  tasks  or  commons  are 
installed  in  or  attached  to  the  partition,  the  partition  is  not 
eliminated  and  ^/MR  generates  an  error  message. 

/PLCTL[=high]  [ : [low)  [  :  [frsiz]  ( tbasepj ) ) ) 

(Systems  with  pool  monitoring  support  only.)  Sets  the  pool  limit 
parameters  used  by  the  Pool  Monitor  Task  (PMT).  The  following 
list  defines  the  paraneters: 


high 


rhe    high    pool    lim:it    In    bytes, 
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low 

Th«  low  pool  limit  in  bytes. 

f  rs  iz 

The  minimum  byte  size  of  the  largest  free  pool  block 
required  for  avoiding  low  pool  actions  by  the  Pool  Monitor 
Task  (PMT...). 

basep 

The  base  task  priority,  which  is  the  lowest  priority  a 
nonpr ivi leged  task  can  have  and  still  be  eligible  for  memory 
contention  during  times  of  low  pool;  thin  priority  remains 
in  tffect  until  pool  conditions  improve.  (Note  that  only 
chose  tasks  requested  to  run  while  the  system  is  in  a  low 
por 1  state  are  affected). 

The  followit.T  list  defines  the  limits  of  the  parameters: 

84.   <»low  <»high  <«total  size  of  system  pool 

84.  <"frsiz  <»high 
0.  <»basep  <=250. 
The  following  list  gives  the  defaults  for  the  parameters: 

high      1600.  bytes 

low       600.  bytes 

frsiz     200.  bytes 

basep     51. 

See  the  RSX-IT/M-PLUS  System  Management  Guide  for  information   on 
determining  the  values  for  the  parameters. 

When  you  omit  tne   parameter   specifications,   VMR  displays   the 
current  parameters  for  the  system. 

/POOL[-topl 

Increases:  the  size  of  the  dynamic  storage  region  (pool). 

top 

The  first  location  in  memory  used  for  partition  allocation. 
You  specify  top  in  units  of  64-byte  blocks,  in  octal  or 
decimal . 

When  you  do  not  specify  top,  VMR  displays  the  virtual 
address  of  the  top  of  the  Executive,  the  size  of  the  longest 
block  of  pool  space  in  words,  the  total  number  of  words  in 
the  pool,  and,  on  RSX-llM-PLUS,  the  lowest  physical  address 
at  which  a  partition  can  start.  (You  can  use  the  address 
when  calculating  partition  layouts  for  systems  supporting 
kernel  data  space.  If  your  system  is  not  a  kernel  data 
space  system,  this  value  is  always  equal  to  the  virtual 
address  of  the  top  of  pool.)  The  display's  format  is: 

POOL=top:max : total [: par  J 
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where  top  ia  given  in  units  of  64-byte  blocks,  max  and  total 
are  in  decimal  words,  and  par  is  the  lowest  physical  address 
(32-word  blocks) . 

You  can  also  specify  top  by  using  a  wildcard  (*).  Thfr 
wildcard  directs  VMR  to  supply  the  maximum  amount  of  pool 
possible.   Specify  the  wildcard  as  follows: 

/POOL-* 

If  you  request  more  pool  than  can  be  supplied,  VMR  prints  a 
warning  message  and  supplies  the  maximum  amount  of  pool 
possible . 

/POOLSIZE[-value] 

Specifies  a  total  amount  of  pool  rather  than  a  top  address. 

If  you  do  not  specify  a  value,  VMR  displays  the  virtual  address 
of  the  top  of  the  Executive,  the  size  of  the  longest  block  of 
pool  space  in  words,  the  total  number  of  words  in  the  pool,  and 
the  lowest  physical  address  at  which  a  partition  can  start 
(32-word  blocks) . 

/PRIV[-ttnn:l 

Sets  the  specified  terminal  to  privileged  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
privileged  terminals  in  thf  system. 

/NOPRIVt-ttnn:] 

Sets  the  specified  terminal  to  nonprivileged  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
nonprivileged  terminals  in  the  system. 

/PUB(=ddnn:] 

Establishes  the  specified  device  as  a  public  device. 

When  you  omit  the  device  specification,  VMR  displays  all  the 
public  devices  in  the  system. 

/NOP0B(=ddnn:] 

Causes  the  specified  device  to  lose  its  public  status. 

When  you  omit  the  device  specification,  VMR  displays  all  the 
nonpublic  devices  in  the  system. 

/REMOTE[=ttnn: [speed] ) 

Declares  that  the  specified  terminal  is  connected  to  a  modem  and 
can  be  connected  to  the  system  by  means  of  a  dial-up  network. 
The  terminal  has  a  line  to  a  DHll,  DHVll ,  DLll,  DLVll,  DZH,  or 
DZVll  multiplexer. 

Specifying  speed  establishes  the  initial  baud  rate  (answer  speed) 
of  the  remote  dial-up  line  for  the  specified  terminal.  You  may 
specify  an  answer   speed   only   for   DHlls,   DHVlls,   DZlls,   and 
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DZVlls,  which  are  variable-speed  multiplexers.  (You  cannot 
specify  an  answer  speed  for  DLlls  or  DLVlls.) 

Valid  speeds  for  the  DHll  are  0,  50,  75,  110,  134.5,  150,  200, 
300,  600,  1200,  1800,  2400,  4800,  9600,  EXTA  (user-specified  baud 
rate  A),  and  EXTB  (user-specified  baud  rate  B) . 

Valid  speeds  for  the  DHVll  are  75,  110,  134.5,  150,  300,  600, 
1200,  1800,  2000,  2400,  4800,  9600,  and  19200. 


I  Valid  speeds  for  the  DZll  and  DZVll  are  50,  75,  110,  134.5,  150, 
300,  600,  1200,  1800,  2000,  2400,  3600,  4800,  7200,  and  9600. 

When  you  omit  the  terminal  spocif icat ion,  VMR  displays   all   the 

I  remote  terminals.  When  you  omit  the  speed  specification,  the 
current  setting  for  the  terminal  remains  in  effect. 

/NOREMOTEl-ttnn:] 

Establishes  the  terminal's  line  as  a  local  line  not  connected  to 
a  modem. 

When  you  omit  the  terminal  specification,  VMR  clinplays  all  the 
local  terminals. 

/RNDC[-nnl 

•  Defines  the  length  of  the  Executive  round-robin  scheduling 
interval  in  ticks.  The  parameter  nn  can  be  an  octal  value,  or 
decimal  value  if  followed  by  a  period  (.).  The  minimum  value  for 
nn  is  0.  See  the  RSX-llM  or  RSX-llM-PLUS  System  Generation  and 
Installation  Guide  for  more  informat  ion . 

When  you  omit  the  length  specification,  VMR  displays  the  current 
value  for  the  interval. 

/RNDH(«nn) 

•  Defines  the  highest  priority  (1  through  250  decimal)  that  will  be 
considered  for  Executive  round-robin  scheduling.  The  priority 
class  must  bo  higher  than  the  one  specified  with  the  /RNDL 
keyword.  See  the  RSX-llM  or  RSX-llM-PLUS  System  Generation  and 
Installation  Guide  for  more  information. 

When  you  omit  the  priority  class,  VMR  displays  the  current  value 
for  the  priority. 

/RNDL(-nnl 

•  Defines  the  lowest  priority  (1  through  250  decimal)  that  will  be 
considered  for  Executive  round-robin  scheduling.  The  priority 
class  must  be  lower  than  the  one  specified  with  the  /RNDH 
keyword.  See  the  RSX-llM  or  RSX-llM-PLUS  System  Generation  and 
Installation  Guide  for  more  informat  ion . 

When  you  omit  the  priority  class,  VMR  displays  the  current  value 
for  the  priority. 

/RPA[»ttnn:] 

(Full-duplex  terminal  driver  only.)  Enables  the  read-pass -al 1 
option.  The  terminal  driver  passes  all  characters  input  at  the 
keyboard  to  the  terminal's  input  buffer. 
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Nhon  you  onit  tha  torninal  apocif ication,  VMR  diaplaya  all  tha 
tarminals  on  tha  aystam  that  hava  tha  raad-paaa-all  option 
anablad. 

/NORPA(-ttnn:] 

(Pull-duplax  tarninal  drivar  only.)  Diaablaa  tha  raad-paaa-all 
option.  Tha  tarminal  drivar  does  not  pasa  spacial  function 
charactara  (for  axampla,  CTRL/C)  input  at  tha  kayboard  to  tha 
tarminal 'a  input  buffar. 

When  you  omit  the  terminal  aprci f ication,  VMR  diaplays  all  tha 
terminala  on  the  system  that  have  the  read-pass-all  option 
disabled . 


/8ICP0L 

(■8X-11 
systaai. 

-H-PL08  syatOT 
Tha  display 

IS  only.) 
is  in  tb« 

Diaplayc 
Collowii 

aacondary  pool  i 
ng  fotaatt 

iiaa  in 

tha 

SICPOL-s«cf r  tsacsi 

s:polcfc 

s«cfr 

Tha  nisibttr  of  fc«s 
32-iford   (dcclMil) 

1     blocks 
blocks. 

in     aacondary     pool     in 

unita 

of 

sscsis 

Tha  aisa  of  aacondary  pool  in  unita  of  32-vord   (daciaal) 
blocka. 

pctfr 

Tha  parcantaga  of  f ceo  blocka  in  secondary  pool . 

/SLAVE [«ttnn:) 

Establishes  the  specified  terminal  as  one  that  can  enter  data 
only  if  it  is  solicited  by  a  task.  Thus,  the  specified  terminal 
always  rejects  unsolicited  input  (other  than  CTRL/0,  CTRL/Q,  and 
CTRL/S) . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  currently  classified  as  slaved. 

/NOSLAVE["ttnn:J 

Sets  the  specified  terminal  to  nonslaved  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  currently  classified  as  nonslaved. 

/SPEED-ttnn: [recv:xmlt] 

Establishes  the  receive  and  transmit  baud  rate  for  terminals 
attached  to  the  system  through  a  DHll,  DHVll,  DZII,  or  DZVll 
variable-speed  multiplexer.  The  recv  argument  is  the  baud  rate 
at  which  characters  are  input  to  the  computer  from  the  terminal. 
The  xmit  argument  is  the  baud  rate  at  which  characters  are  output 
to  the  terminal  from  the  computer.  You  must  specify  both 
arguments  when  setting  the  speed.  If  you  do  not  < specify  either 
argument,  VMR  will  display  the  current  settings. 
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Valid  baud  rates  for  the  DHll  are  0,  50,  75,  110,  134.5,  150, 
200,  300,  600,  1200,  1800,  2400,  4800,  9600,  EXTA  ("jser-apeci  f  led 
baud  rate  A),  and  EXTB  (user-specified  baud  rate  B) . 

Valid  baud  rates  for  the  DHVll  are  75,  110,  134.5,  150,  300,  600, 
1200,  1800,  2000,  2400,  4800,  9600,  and  19200. 


I  Valid  baud  rates  for  the  DZll  and  DZVll  are  50,  75,  110,  134.5 
150,  300,  600,  1200,  1800,  2000,  2400,  3600,  4800,  7200,  and 
9600. 

I  If  you  have  a  DZll  or  DZVll,  the  receive  and  transmit  baud  rates 
mi'St  be  the  same  because  these  multiplexers  do  not  support  split 
speeds. 

/SOB"«inaBie : sname ( tbaseisise] 

(R8X-11N  systems  only.)  Bstabllshas  •  •ubpartition. 
Subpartitions  can  only  be  established  in  user-controlled  aain 
partitions. 

■name 

The  1-  through  6-character  main  partition  nane.  The 
subpartition  being  defined  becomes  a  subpartition  in  the 
named  main  partition. 

snane 

The  1-  through  6-character  subpartition  name.  The 
subpartition  being  defined  becomes  a  subpartition  of  the 
■ain  partition  specified  in  mname. 

base 

The  physical  base  address  of  the  subpartition,  specified  •• 
a  number  of  64-byte  blocks. 

site 

The  sise  of  the  subpartition,  specified  as  a  number  of 
64-byte  blocks. 

Base  and  else  may  be  entered  in  any  of  the  following  formats; 
nnnn  is  a  number  to  which  the  system  applies  a  multiplication 
factor  to  determine  the  value  used. 

rocsMt    Calculated  Valae 

n  Octal  (nnnn*100) 

n.  Decimal  (nnnn.*64.) 

nK  Octal  K  (nnn*4000) 

■•I  Decimal  K  (nnn.*2048.) 

Valid  ranges  for  calculated  values  are: 

Octal  0<-base<10000  0<size<2000 

Decimal  0.<-ba8e<4096.  0.<size<1024. 

Octal  K  0K<-ba8e<2C0K  0K<size<40K 

Decimal  K  O.K<-base<2047.K  0.K<sise<32.K 

Bxaaple  t 

Any  of  the  following  inputs  for  sise  will  allocate  a 
2048 (10) -byte  subpartition. 
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sa. 

IK 
I.R 

If  baa*  and  alia  ara  oaiittad,  VNR  diapiaya  tha  ourrant  values  for 
tha  naaad  aubpartltlon. 

/NOSOBaainaaa  i  anaaa 

Rlialnataa  tha  apeclflad  aubp^stltion  froa  tha  main  partition. 

/SWPC(-nn) 

Defines  the  number  of  clock  ticks  foe  a  single  Executive  swapping   • 
interval.    The  parameter  nn  is  in  the  range  0  through  45,568(10) 
and  can  be  an  octal  value,  or  decimal  if   followed   by  a   period 
(.).    See   the   RSX-llM  or   RSX-llM-PLUS   System  Generation  and 
Installation  Guide  for  more  information. 

When  you  omit  the  clock  ticks  -specification,  VMR  displays  the 
current  value  for  the  inter. ^1. 

/SWPR(-nnl 

Defines  a  priority  range  for  Executive  swapping.    The  parameter   • 
nn   is   in  the  range  0  through  127(10)  and  can  be  an  octal  value,   I 
or  decimal  if  followed  by  a  period  (.).   The  highest   number   is 
the  highest  priority. 

The  value  for  the  /SWPR  keyword  affects  the  installed  priority  of 
all  tasks.  Each  task  is  initiated  at  its  installed  priority  plus 
the  value  for  un  (priority  +  nn)  .  While  the  task  is  execL'*-ing, 
its  priority  is  decremented  until  it  becomes  the  installed 
priority  minus  the  value  for  nn  (priority  -  nn) .  When  the 
priority  reaches  this  lower  limit,  the  task  is  swapped  out  so 
that  another  task  with  a  higher  priority  can  execute.  The 
priority  for  the  new  task  changes  in  the  same  way.  See  the 
RSX-llM  or  RSX-llM-PLOS  System  Generation  and  Installation  Guide 
for  more  information. 

When  you  omit  the  range  specification,  VMR  displays  the  current 
value  for  the  priority  range. 

/SYSUICt-[uic] ] 

Establishes  the  UIC  for  the  system  and  all  system  tasks.  The  UIC 
has  the  format  [g,m],  where  g  and  m  are  octal  numbers  that 
represent  a  group  and  member  number,  respectively.  On  most 
unmapped  systems,  the  system  UIC  is  [1,50];  on  most  mapped 
systems,  the  system  UIC  is  [1,54).  These  UIC  values  are  the 
initial  defaults  on  virgin  systems. 

The  UIC  specified  with  the  /SYSUIC  keyword  also  becomes  the 
default  UIC  used  by  the  LOAD  command  'nd  the  install-run-remove 
option  of  the  MCK  RUN  command. 

When  you  omit  the  UIC  specification,  VMR  displays  the  current 
system  UIC. 
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/Tini'ttnns  (typ«) 

(Pull-dupl«i  taminal  driv«r  only,)  Bstablishas  th«  tarainal  typ* 
of  th«  spacifiad  tarainal.  Whan  VHR  aata  tha  tarninal  typ*,  it 
autoaatically  aata  thr>  HPILL,  VPILL,  CRT,  PORHPEED,  and  HHT 
chacactariatica  for  tha  taminal.  Tha  atandard  tarainal  typaa 
ara  aa  followa: 


A8R33 

LA30S 

LA120 

VT55 

VT105 

ASR35 

'.hU 

LA180S 

VT61 

VT125 

RSR33 

LA36 

VT05B 

VTIOO 

VT131 

LA12 

LA38 

VT50 

VTlOl 

VT132 

LA30P 

LAIOO 

VT52 

VT102 

If  you  apacify  a  tanninal  typa  that  ia  unknown  to  VHR,  VHR  doaa 
not  aat  any  davica  character iatica  for  the  tarminal .  Howavar , 
VHR  atoraa  the  value  you  have  apecified  in  the  Unit  Control  Block 
(UCB) . 

tfhan  you  onit  the  type  paraneter,  VHR  diaplaya  the  ter:ninal  type 
of  the  apecified  terninal. 

VHR  alao  accepta  an  alternate  form  of  the  coimand .  You  can 
apecify  the  terminal  type  and  equate  it  to  the  deaired  terminal. 
Thia  automatically  aaaociatea  certain  character iatica  of  the 
particular  terminal  type  with  the  apecified  terminal.  (See  th~ 
R8X-11H/H-PLUS  I/O  Drivera  Reference  Hanual  for  a  liat  of  the 
implicit  characteriatica  for  each  terminal  type.)  The  command  ia 
in  the  format: 

SET  /term-type-TTnn: 

where  term-type  ia  one  o^  the  atandard  terminal  typea.  Note  that 
the  terminal  typea  are  mutually  excluaive. 

Thw  half-duplex  terminal  driver  alao  accepts  the  /term-type  form 
of  the  command.  However,  the  only  legal  terminal  types  for  the 
half-duplex  driver  are  /ASR33,  /LA30S,  and  /VT05B.  The  command 
aaaociatea  implicit  characteristics  of  the  terminal  type  with  the 
apecified  terminal,  but,  unlike  the  full-duplex  terminal  driver, 
the  types  are  not  mutually  exclusive. 

The  following  list  describes  the  effects  of  the  keywords  for  the 
half-duplex  terminal  'Iriver: 

/ASR33  Converts  lowercase  letters  to  uppercase  before 
they  are  output  to  the  terminal. 

/LA30S  Indicates  that  fill  characters  are  used  after  a 
carriage  return.  The  number  of  fill  characters 
used  depends  on  the  current  carriage  position  at 
the  time  the  carriage  return  occura. 

/VT05B  Sets  a  vertical  file  of  three  nulls  after  a  line 
feed  on  60  Hz  systems  and  of  four  nulls  on  50  Hz 
systems. 
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/TOP-pname : va 1 u« 

Directs  VMR  to  move  the  top  boundary  of  the  specified   partition 

up  or   down   the   amount   indicated  by  the  value  parameter.   The 

keyword  modifies   the   top  boundary   of  a    system-controlled 
partition  even   if   the  partition  has  tasks  installed  in  it.   If 

you  modify  the  partition  ao  that  it  becomes  too  small  to  hold  the 

tasks   installed   in   it,   VMR   displays   a  warning  message  but 
modifies  the  partition  anyway. 

pname 

The  1-  through  6-character  alphanumeric  partition  name, 
value 

The  number  of  64-byte  blocks. 

The   value   parameter   can   be   supplied   in   five   formats: 
'•■value,  -value,  value,  +*  or  *,  and  -* . 


■fvalue 


Moves  the  top  boundary  up  by  the  specified   amount.    Moving 
the  top  boundary  up  makes  the  partition  larger. 


NOTE 

You  can  supply  the  value  in  the  same   units   as   the 
br.se  and  size  parameters  for  the  /PAR  keyword. 


-value 


Moves  the  top  boundary  down  by  the  specified  amount.   Moving 
the  top  boundary  down  makes  the  partition  smaller. 


value 


Establishes  the  total  partition  size  equal  to  the   specified 
value  by  moving  the  top  boundary. 


+*  or 


_* 


Moves  the  top  boundary  up  as  far  as  possible.  This  format 
causes  the  top  boundary  to  move  to  the  bottom  boundary  of 
the  partition  above  it  or  to  the  top  of  memory  if  the 
partition  is  the  top  partition  in  memory. 


Moves  the  top  boundary  down  as  far  as  possible.  This  format 
causes  the  top  boundary  to  move  down  to  the  top  of  the  first 
fixed  task,  common,  or  driver  in  the  partition  at  the  time 
the  /TOP  keyword  is  executed.  If  nothing  is  loaded  into  the 
partition,  the  partition  assumes  a  size  of  one  64-byte 
block. 
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/TYPBAHEAD(-ttnn: [size] ] 

(Full-duplex  terminal  driver  only.)  Enables  the  typeahead  option 
for  the  specified  terminal.  The  terminal  driver  stores  input 
characters  in  a  buffer  before  passing  them  to  a  requesting 
attached  task.  Thus,  characters  input  during  periods  between 
requests  are  not  lost. 

If  sis*  is  specified  (RSX-llM-PLUS  systens  that  support  kernel 
data  apace  only),  tha  typaahead  buffar  sixe  is  aat  accordingly. 
The  valua  foe  aiza  can  be  fron  0  through  255(10).  If  you  apacify 
0  or  1,  tha  terminal  will  not  hava  tha  typaahaad  option  anablad 
(aaaa  affact  as  /MOTYPBAHBAD) .   Tha  default  for  sisa  ia  86(10). 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  typeahead  option  enabled. 

/NOTYPEAHEAD[-ttnn:] 

(Full-duplex  terminal  driver  only.)  Disables  the  typeahead  option 
for  the  specified  terminal.  The  terminal  driver  does  not  store 
characters  to  prevent  their  loss  because  the  size  of  the  buffer 
is  forced  to  1. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  the  typeahead  option  enabled. 

/UlCl-tuicl :ttnn:] 

Establishes  the  specified  UIC  as  the  default  UIC  for  the 
specified  terminal  (the  default  is  TI:).  All  tasks  run  from  the 
terminal  are  run  with  the  UIC  of  the  terminal,  except  in  a 
multiuser  protection  sy.item.  In  such  a  system,  a  privileged  user 
can  override  the  ter.nii..  1  UIC  with  the  /UIC  keyword  of  the  RUN 
command.  Furthermo-e,  C}:tci.nal  MCR  function  tasks  are  requested 
with  this  UIC.  These  tasks  are  the  MOUNT,  INSTALL,  DM0,  and  UFD 
commands  (which  run  as  tasks),  and  all  system-supplied  software. 

When  you  specify  only  the  terminal,  VMR  displays  the  UIC  for  that 
terminal . 

/VFILLl-ttnn:] 

(Full-duplex  terminal  driver  only.)  Enables  the  vertical  fill 
characters  option  for  the  specified  terminal.  The  terminal 
driver  adds  four  fill  characters  following  each  line  feed. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  VFILL  option  enabled. 

/IIOVFILL(-ttnn:] 

(Full-duplex  terminal  driver  only.)  Disables  the  vertical  fill 
characters  option  for  the  specified  terminal.  The  terminal 
driver  does  not  add  any  vertical  fill  characters  following  line 
feeds . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  do  not  have  the  VFILL  option 
enable<. . 
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/MCHK(-ddnn:] 


Specifies  for  all  Files-11  devices,  except  DX:,  DY:,  and  magnetic 
tapes,  that  all  write  operations  are  to  be  followed  by  a  write 
check.  The  checks  assure  the  reliability  of  data  transfers  to 
the  specified  disk. 

On  RSX-llN,  Executive  support  for  write  checking   is  a   syaten 

generation   option   and  must  be  selected  for  this  command  to  have 

any  effect.  On  RSX-llH-PLUS,  support  for  writ*  checking  la 
always  Includad. 

When  you  omit  the  device  specification,  VMR  displays  all  Flles-11 
disk  drives  with  write  checking  enabled. 

/NOWCHK[-ddnn:] 

Specifies  that  write  checking  is  to  be  disabled  for  the  specified 
device. 

When  you  omit  the  device  specification,  VMR  displays  all  disks 
that  support  write  checking  but  have  the  option  disabled. 

/WRAP(-ttnn:) 

(Full-duplex  terminal  driver  only.)  Enables  the  wrap-around 
opliion  for  the  specified  terminal.  The  terminal  driver 
automatically  generates  a  carriage  return/line  feed  sequence  when 
the  number  of  input  characters  exceeds  the  buffer  size  of  the 
specified  terminal.  Both  the  carriage  return  and  line  feed  are 
transparent  and  do  not  appear  in  the  input  buffer. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  wrap-around  option  enabled. 

/NOWRAP(-ttnn:] 

(Full-duplex  terminal  driver  only.)  Disables  the  wrap-around 
option  for  the  specified  terminal.  The  terminal  driver  does  not 
accept  input  characters  beyond  the  input  buffer  size  for  the 
terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  wrap-around  option 
disabled . 

■otas  on  Haaiery  Allocation  Kayworda 

1.  If  a  command  attempts  to  eliminate  a  partition  in  which  tasks 
are  installed  or  drivers  loaded,  VMR  rejects  the  comoiand 
until  the  tasks  have  been  removed. 

2.  When  you  define  a  partition,  the  name  must  not  already  be 
defined  as  a  partition.  In  addition,  a  partition  cannot 
overlap  any  other  partition. 

On  RSX-llM,  aubpartltlona  can  overlap  other  aubpartltiona. 

3.  The  address  specified  with  the  /POOL  keyword  must  be  lower 
than  the  base  address  of  the  first  partition  in  the  system. 

On  RSX-llN,  an  exception  la  the  partition  LDRPAR  for  a 
raaidant  loader.   LDRPAR  la  in  the  Executive. 
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4.  Onc«  you  hav*  allocatad  apaca  to  tha  dynamic  atoraga  ragion 
(pool),  you  cannot  cocovar  the  apaca  four  uaa  In  partltiona. 

5.  Mhan  tha  highaat  memory  addreaaea  of  a  ayatem  are  allocated, 
tha  alia  of  tha  partition  la  modified  automatically  to 
reflect  the  amount  of  memory  preaent  when  the  ayatem  ia 
bootatrapped. 

C.  On  MX'llN-rLOt,  SIT  /TOP  and  8ST  /BOT  wock  cocr*ctly  foe 
••cottdary  pool  partition*. 

7.  If  the  laat  partition  ia  ayatan-cc  itrolled ,  ita  top  addreaa 
ia  modified  by  the  SAVE  command  at  boot  time  to  reflect  the 
actual  top  of  phyaical  memory  of  the  hardware  in  uae. 

Bxaaplea 

VMR>SET  /ABAUD-TT4: 

Enablea  the  autobaud  detection  option  for  TT4:. 

VMR>SET  /ABAUD 
ABAUD-TT2: 
ABAUD-TT4: 
ABA0D-TT5 : 

Diaplaya  all  the   terminala   that   have   the   autobaud   detection 
option  enabled. 

VMR>SET  /BR0-TT5: 

Enablea  the  broadcaat  option  for  TT5:. 

VNR>SET  /BRO 
BR0-TT2: 
BR0"TT4: 
BR0-TT5: 

Diaplaya  all   the   terminala   that   have  the  broadcaat  option 
enabled. 

VMR>SET  /BUF-L.PO: 
BOP-LP0:132. 

Diaplaya  the  current  buffer  aize  of  LPO:. 

VMR>SET  /BUP-TT1:40. 

Seta  the  buffer  aize  of  TTl:   to  40(10). 

VMR>SET  /CRT-TT3: 

Enablea  the  baclcwarda  deletion  option  on   the  diaplay   terminal 
whoae  number  ia  TT3:. 

VMR>SET  /CRT 
CRT-TT3: 
CRT-TT7 : 
CRT"TT12: 

Diaplaya  all  the  terminala   that  have  the  bac)cward8  deletion 
option  enabled. 
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VMR>SET  /E8CSE0-TT3: 

E8tabli»he«  terminal  TT3:    as   a   terminal   that   can   lend   and 
receive  escape  sequences. 

VMR>SET  /ESCSEQ 
ESCSE0-TT3: 
ESCSEQ-TT7: 
ESCSEQ- TT16: 

Displays  all  the  terminals   that  can   send   and   receive   escape 
sequences. 

VMR>SET  /NOESCSE0-TT3: 

Disables  support  of  escape  sequences  for  TT3:. 

VMR>SET  /LA30S-TT2: 
VMR>SET  /LA30S 
LA30S-TT0: 
LA30S-TT2: 

Sets  TT2:   as  an  LA30S,  then  displays  all  LA30S  terminals. 

VMR>SET  /NETUIC 
NETUIC-[ (20,31 ) 

Displays  the  current  network  UIC. 

VMR>SET  /NETUIC- (25,6) 

Sets  the  network  UIC  to  (25,6]. 

VHR>SST  /opT'OHi tnmhtt 

BnablM  I/O  quaue  optiaisation  for  DMlt,  osing   tha   MBAR 
•IgocitlM. 

VMit>SBT  /OPT 
OPT-DBOiMEAR 
OPY-DtltNBAR 
OPT-DMOtMBAR 
0PT-DN1:HBAR 

Displays  all  tha  disk  aavicas  that  hava  I/O  qoaua  optiaiiation 
anablad. 

VMR>SET  /PLCTL 
PLCTL-1600. :600. :200. :51. 

Displays  the  current  pool  limit  parameters  used  by  the  Pool 
Monitor  Task. 

VMR>SET  /PRIV-TTO: 

Sets  TTO:   to  be  a  privileged  terminal. 

VMR>SET  /PRIV 

PRIV-TTO: 

PRIV-TTl: 

Displays  all  privileged  terminals. 
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VMR>SET  /REM0TE-TT21J 

Sets  the  terminal   line  corresponding   to   TT21:    as   a   remote 
dial-in  line. 

VMR>SET  /REMOTE 

REMOTE-TTl: 

REMOT5-TT2: 

REM0TE-TT3: 

REM0TE-TT4: 

REM0TB-TT21: 

Displays  all  the  terminals   that   are  currently  set   as   remote 
dial-in  lines. 

VMR>SET  /RNDC 
RNDC-6. 

Displays  the  current  length  of   the  round-robin   scheduling 
interval . 

VMR>SET  /RNDC-10. 

Sets  the  length  of  the  round-robin  scheduling  interval  to   10(10) 
ticks. 

VHR>SB7/SECP0L 
SBCPOL-28S.:640:44% 

Displays  th«  amount  of  sacondary  pool  ourrantXy  baing  usad*^ 

VMR>SET  /SLAVE-TT3: 

Sets  TT3:  to  be  a  slaved  terminal. 

VMR>SET  /SWPR 
SWPR-5. 

Displays  the  current  value  for  the   Executive  swapping  priority 
range. 

VMR>SET  /3WPR-10. 

Sets  the  Executive  swapping  priority  range  to  10(10). 

VMR>SET  /VT05B 
VT05B-TT4! 
VT05B-TT5: 
VT05B-TT6: 

Displays  all  VT05B  terminals. 

VMR>SET  /WCHK-DKl: 

Fiables  write  chec)(ing  on  DKl:. 

VMR>8ET  /PAR-SYSPAR:420:140!SVS 

Oafinas  a  pcctition  callad  8YSPAR  whose  baaa  addraaa  is  42000(8) 
and  tfhosa  langth  is  14000(8)  bytaa. 
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VHR>SBT   /NOPJt.R«SYSPAR 

lfell«in«t«B  th«  «ain  partition  8T8PM. 

Vm>SIT   /PAR-GBNt*l* 

Cr«at«s  •  partition  nanad  GBN,  aatting  tha  baaa  addraaa  aa  low  aa 
poaaibla  and  nakinq  tha  partition  aa  iarga  aa  poaaibla. 

VMR>SET  /POOL-420 

Eatablishea  the  top  of  the  dynamic  storage  region  (pool). 
Following  this  command,  no  user-defined  partition  can  begin  below 
42000(8) . 

VMR>SET  /POOL 

POOL- 1200: 11470.: II 738.: 200 3 

Shows  that  the  last  virtual  address  in  the  Executive  is  120000, 
the  longest  free  block  is  11470(10)  words,  and  the  total  of  all 
pool  space  is  11738(10)  words.  The  lowest  physical  address  at 
which  a  partition  can  start  is  2003  (32-word  blocks). 
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TA8RLIST 

Usr  the  TASKLIST  command  to  display  a  description  of  each  installed 
task  in  the  system.  The  display  contains  several  columns  that  give, 
from  left  to  right,  the  following  information: 

1.  Task  name 

2.  Task  version  identification 

3.  Task  Control  Block  address 

4.  Partition  name 

5.  Task  priority 

6.  Size  of  task  in  bytes  (octal) 

7.  Load  device  identification 

8.  Disk  address  logical  block  number  (in  octal)  on  virgin 
systems,  or  the  image  or  task  file  identification  on  saved 
systems 

9.  Task  memory  state  (saved  systems  only) 

On  R8X-11M-PLUS,  th«  display  lists  th«  tasks  installed  in  prinary  pool 
and  then  those  install«»d  in  secondary  pool.  The  tasks  in  secondary 
.jpool  are  indicated  by  a  plus  sign  {+) . 

Pornat 

TAS[KLIST]  [tasknam<f] 

Paraaeters 

taskname 

The  name  of  a  single  installed  task,  the  description  of  which  you 
would  like  to  be  displayed. 

Examples 

This  example  is  from  a  virgin  system: 

VMR>TAS 


TKTN    03.14 
...MCR  01.01 
MCR ...  3.3 
...INS  4 
...LOA  03.3 
...UNL  03.4 
VMR> 


035300  GEN  248.  00010000  LBO :-00631420 

035174  GEN  160.  00040000  LBO :-00630300 

035070  GEN  160.  00010000  LBO :-00627721 

035614  GEN  100.  00040000  LBO :-00627333 

035510  GEN  50.  00040000  LBO :-00627643 

035404  GEN  50.  00040000  LBO :-00070512 


On  a  system  image  generated  for  a  PDP-11/70  with  more  than  124K 
words  of  memory,  the  size  field  (sixth  column)  contains  8-digit 
rather  than  6-digit  numbers. 
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This  example  Is  from  a  saved  system: 


TAS  (Cont.) 


VMR>TAS 

LOR... 

08.03 

034210 

LDRPAR 

248. 

00003000 

LBO- 

-  FILE 

ID: 

(1111,12)  FIXED 

TKTM 

03.14 

115424 

GEN 

248. 

00010000 

LBO: 

-  PILE 

ID: 

(31540,27) 

H'^KhCr 

0010 

115214 

GEN 

200. 

00013500 

LBO: 

-  FILE 

ID; 

(31461,24) 

WVu  K  •  ■  • 

3.3 

116464 

SYSPAR 

160. 

00010000 

LBO; 

-  PILE 

ID! (31454,12) 

...DCL 

0113A 

115634 

GEN 

160. 

00040000 

LBO 

-  FILE 

ID: 

(31344,53) 

DCL... 

0113A 

115530 

GEN 

160. 

00010000 

LBO 

-  PILE 

ID- 

(31345,5) 

•  •  •  HviK 

01.01 

036770 

GEN 

160. 

00040000 

LBO 

-  PILE 

ID' 

(30546,34) 

...HOU 

23.00 

036250 

GEN 

160. 

00040000 

LBO 

-  PILE 

ID 

(5424,15) 

FllACP 

H0320 

117674 

GEN 

149. 

00065700 

LBO 

-  PILE 

ID 

(30101,47) 

DBOOPl 

M0320 

117570 

GEN 

149. 

00065700 

LBO 

-  PILE 

ID 

(31370,6) 

COT... 

XOO.Ol 

117360 

GEN 

145. 

00015400 

LBO 

-  FILE 

ID 

(31336,120) 

...DHO 

23.00 

117254 

GEN 

140. 

00040000 

LBO 

-  PILE 

ID 

(31346,23) 

...INI 

20.01 

116674 

GEN 

140. 

00040000 

LBO 

-  PILE 

ID 

(31424,55) 

...UFD 

V0410 

116044 

GEN 

140. 

00040000 

LBO 

-  PILE 

ID 

(31541,34) 

PMO . . . 

3.1 

114630 

GEN 

140. 

00023600 

LBO 

-  FILE 

ID 

(31464,70) 

HRC... 

01.01 

036560 

GEN 

140. 

00050400 

LBO 

-  PILE 

ID 

(31240,21) 

SHF... 

03.01 

115320 

SYSPAR 

105. 

00010000 

LBO 

-  FILE 

ID 

(31521,40) 

FXR... 

01 

117104 

GEN 

100. 

00003100 

LBO 

-  FILE 

ID 

(31371,113) 

...INS 

4 

116570 

GEN 

100. 

00027700 

LBO 

-  FILE 

ID 

(31435,12) 

...SAV 

04.35 

116254 

TSTPAR 

100. 

00040000 

LBO 

-  PILE 

ID 

(31475,5) 

SAVTO 

04.35 

036130 

TSTPAR 

100. 

00040000 

LBO 

:-  FILE 

ID 

(31475,5) 

.  . . PRV 

4.30 

036664 

GEN 

100. 

00040000 

LBO 

>-  F,  E 

ID 

(3433,163) 

...AT. 

04.25 

037254 

GEN 

65. 

00057700 

LBO 

:-  FILE 

ID 

(31421,131) 

...BOO 

04.08 

117464 

GEN 

50. 

00040000 

LBO 

!-  PILE 

ID 

:(31323,6) 

...ACS 

01.1 

115740 

GEN 

50. 

OOO-OOOOO 

LBO 

:-  PILE 

ID 

.  (31321,73) 

•  •  •  HEIj 

01.25 

037360 

GEN 

50. 

00044100 

LBO 

:-  PILE 

ID 

:  (31416,15) 

VMR> 

The  display  for  a  saved  system  differs  from  the  display  for  a 
virgin  system  in  that  the  file-ID  of  the  task  file,  rather  than 
the  logical  block  number,  is  displayed. 

FIXED  indicates  that  the  task  is  fixed  in  memory. 

Thi«  ttxaapl*  is  from  an  R8X-11M-PL0S  saved  systdm  that  has  tasks 
installed  in  secondary  pool: 

vraoTM 


MPO 

02 

113440 

GIN 

80. 

00045700 

LBO:- 

FILB 

ID: (4332,27) 

QMQ... 

1.7 

112450 

GBM 

75. 

00031400 

LBO:- 

FILE 

ID: (4366,2) 

LtO 

1.9 

11X734 

GBM 

70. 

00015400 

L80:- 

FILE 

101(4354,135) 

Lri 

1.9 

112«04 

GBM 

70. 

00015400 

LBO:- 

FILE 

101(4354,135) 

BIW««  •  •  • 

01.01 

11C600 

GBM 

€0. 

00051700 

LBOt- 

FILE 

ID: (4360,2) 

8H0T0P 

02 

110320 

GBM 

50. 

00011200 

LBO:- 

FILE 

IO:(«320,65) 

...DM0 

23.20 

00«02S-f 

GBM 

160. 

00015500 

LBO:- 

FILE 

ID: (4167,35) 

. « .nCK 

2.4 

00S0374- 

GBM 

160. 

00032000 

LBO:- 

FILE 

ID: (2132,227) 

...MOO 

2S02 

00(041-»^ 

GBM 

160. 

00040000 

LBO:- 

FILE 

ID: (4205,13) 

...DCI> 

00 

0061304 

GBM 

160. 

00035600 

LBO:> 

FILE 

ID: (2535,1525) 
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TIM 

TIM 

Ose  the  TIME  command  to  set  the  time  of  day  and  the  date  or  to  display 
the  time  and  date. 

roraats 

TIM[E]  [hr* :mina ( :8ec8] ]  [ml/day/year] 

oc 

TIM[E]  [hrs imins [ isecs] 1  [day-m2-year] 
Paraaeters 
hrs 

Hours  (range  0  through  23) . 
mins 

Minutes  (range  0  through  59). 

sees 

Seconds  (range  0  through  59).   This  parameter  is   optional;    the 
default  is  zero. 

nl 

Numeric  representation  of  month  (range  1  through  12). 
■8 

Three-letter  abbreviation  for  month. 
day 

Day  (range  1  through  31) . 

year 

Ye<*r  (range  0  through  99).   Year  is  relative  to  1900;   thus,  1983 
is  entered  as  83. 

Examples 

>TIM 

10:23:31  03-FEB-83 

Displays  the  current  system  image  time  and  date. 

>TIM  14:30  4/11/83 

Sets  the  time  to  14:30:00  and  the  date  to  ll-APR-83. 
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TIM  (Cont.) 


Het«s 


1.  If  you  specify  neither  time  noc  date,  VMR  displays  the 
current  system  image  time  and  date. 

2.  If  you  specify  the  time  and  date,  VMR  sets  the  system  image 
clock  and  calendar.  If  you  specify  only  the  time,  VMR  seta 
only  the  clock;  if  you  specify  only  the  date,  VMR  sets  only 
the  calendar. 

3.  You  can  specify  the  time  and  date  in  any  order. 

4.  The  form  used  to  specify  the  date  does  not  affect  the  display 
format.   The  date  is  always  displayed  as  day-month-year. 

5.  All  numeric  values  are  decimal.  No  terminating  period  is 
required. 
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UNF 

oiriz 

Os«  th«  UNFIX  comnand  to  fr««  a  fixad  task  from  the  virtual  mamory   of 
tha  aystam  imaga.   UNFIX  is  tha  complamant  of  tha  FIX  coimnand. 

If  a  fixed  task  exits  or  aborts,  it  still  occupies  the  physical  memory 
In  the  partition. 

rocaat 

UNF (IX]  tasknamel /keyword] 
Parameters 
taskname 

The  task  that  you  want  to  unfix  from  memory. 


/keyword 

One  of  the 

following  keywords 

(RSX-llM- 

>PLOS  systes 

IS  only)  t 

/RBO 
/RON 

■•ywocds 

/RIG 

Specifies 

that  the 

task  tc 

t   be 

unfixed  : 

Is  •  coion 

region. 

/MM 

Specifies 
•egaent  of 

that  the 
which  is 

task 

to  ^ 

IS  a  multii 
unfixed  froa 

iiser  task , 
meaiory. 

the  read- 

-only 

Bxample 

VMR>UNFIX  XKE 

Unfixes  task  XKE,  freeing  the  partition  in  which  it  resides, 


# 
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UNL 


ONLOAD 

OS*  the  UNLOAD  command  to  remove  a  loadable  device  driver  from  the 
•ystem  image.   If  a  device  ia  attached,  it«  driver  cannot  be  unlondtl. 

To  unload  a  device  driver  from  the  system  image,  the  driver's  symbol 
definition  file  must  reside  on  LB:  under  the  same  OFD  as  the  UFD  of 
the  system  image  file.  By  convention,  the  system  UIC  is  tl,50)  for  an 
unmapped  system  and  (1,54)  for  a  mapped  system. 

The  UNLOAD  command  cannot  remove  a  loadable  data  base  from  the  system 
image,  even  if  the  data  base  was  loaded  by  means  of  the  LOAD  command. 

Forsiat 

UNL[OAD]  dd: 
Paraneter 
dd: 

A  2-character  ASCII  device  name 
Example 

VMR>UNL  LP: 

Unloads  the  line  printer  driver  (LPDRV) . 
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10.6   VHR  KRROR  HI88AGBS 

Th«  following  ar«  th«  VMR  command  error  moasages.  Although  j'jst  the 
t«xt  of  the  messages  is  givan  here,  the  messages  actually  appear  in 
one  of  the  following  formats: 

VMR  —  *DTAG*  message 

VMR  —  message 

VMR  —  *  FATAL*  message 

A  diagnostic  message  usually  indicates  that  something  unexpected  may 
have  happened,  but  it  does  not  interfere  with  VMR's  operation. 

An  unmarked  message  usually  indicates  that  VMR   rejected   the   command 

line.    If   the   offending  line   is   in  an  indirect  command  file,  VMM 

ignores  the  rejected  line  and  attempts  to  execute  the  remaining 
command  lines. 

A  fatal  message  also  indicates  that  VMR  rejected  the  command  line.  In 
this  case,  however,  VMR  either  exits  or  resets  itnelf  to  the  beginning 
(that  is,  ENTER  FILENAME:).  If  the  offending  line  is  in  an  indirect 
command  file,  VMR  aborts  without  atteirptinq  to  execute  the  remaining 
command  lines. 

VMR  —  Access  to  common  block  denied 

Explanation:  You  attempted  to  install  a  task  that  has  specified 
illegal  access  to  a  shared  region. 

VMR  —  Aodressing  extensions  not  supported 

Explanation:  You  attempted  to  install  a  task  that  was  built 
using  the  VSfiCT  (virtual  section)  directive  into  a  system  image 
that  does  not  support  the  VSECT  feature. 

VMR  —  Alignment  error 

Explanation:  The  base  address  or  size  of  the  i  irtition  being 
created  with  the  SET  command  conflicts  with  existing  partitions 
or  physical  memory. 

VMR  --  Base  address  must  be  on  a  4K  boundary 

Explanation:  The  virtual  base  address  of  the  task  being 
installed  is  not  aligned  on  a  4K  boundary. 

VMR  —  Base  mismatch  common  block  <commonname> 

Explanation:  The  base  address  of  the  partition  does  not  match 
that  of  the  common  block. 

VMR  —  Cannot  fix  an  I/D  space  task 

Explanation:  You  attempted  to  fix  a  task  that  is  built  with  I- 
and  D-space.   Such  tasks  cannot  be  fixed. 

VMR  —  Cannot  fix  a  task  in  a  system  controlled  partition 

Explanation:  This  is  a  VMR  restriction.  To  fix  a  task  in  a 
system-controlled  partition,  use  the  MCR  FIX  command  and  then 
save  the  system  image. 
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—  Cannot  have  multiple  pool  or  CPU  partitions 

Biplanation:  You  attempted  to  create  a  aeconrlary  pool  partition 
in  a  system  that  already  has  one.  There  can  be  only  one 
secondary  pool  partition  in  a  system. 

VHR  —  Cannot  install  tasks  or  commons  from  other  than  LB: 

Explanation:   SAVE  does  not  allow  saving  of   a   system   that   has 

tasks   and/or   commons  that   were  not  installed  from  the  library 

device  LB:.  Therefore,  a  task  or  common  cannot  be  installed  from 
other  than  LB: . 

VHR  —  Cannot  LOAD/UNLOAD  a  pseudo  device 

Explanation:  When  loading  or  unloading  a  device  driver,  the 
physical  name  of  the  driver  must  be  specified. 

VMR  —  Cannot  UNFIX  a  mapped  common  region 

Explanation:  You  attempted  to  unfix  a  common  region  that  is 
currently  mapped  by  a  task. 

VMR  —  Cannot  UNFIX  the  directive  common 

Explanation:  KSX-llM-PLUS  directive  commons  can  be  removed  but 
not  unfixed.  Because  directive  commons  are  merged  with  DIRllM  as 
they  are  fixed,  the  size  of  a  particular  common  is  unkown. 

VMR  —  Checkpoint  area  too  small 

Explanation:  The  area  allocated  for  checkpointing  in  the  task 
image  file  is  smaller  than  the  partition  into  which  the  task  is 
being  installed.  The  system  image  does  not  support  the  dynamic 
allocation  of  checkpoint  space. 

VMR  —  Checkpoint  space  too  small,  using  checkpoint  file 

Explanation:  This  is  a  warning  message.  The  checkpoint  space 
allocated  in  the  task  image  file  is  too  small  to  hold  the  task 
(usually  because  of  the  /INC  keyword) .  The  system  image  supports 
the  dynamic  allocation  of  checkpoint  space.  It  r\ll  use  the 
checkpoint  file  to  store  the  task  when  it  rolls  it  out  to  disk. 
Since  no  checkpoint  file  exists  when  the  system  is  booted,  you 
should  consider  this  message  to  be  a  fatal  error  if  it  is  issued 
by  any  of  the  system  tasks  while  the  system  is  being  booted. 
These  tasks  are  MCR,  MOU,  and  FllACP. 

VMR  —  Circular  redirect  error 

Explanation:  The  attempt  to  redirect  a  device  failed  because  it 
would  result  in  a  circular  device  list. 

VMR  --  Command  I/O  error 

Explanation:  The  system  detected  an  I/O  error  during  a  read  from 
an  indirect  command  file. 

VMR  —  Command  syntax  error  <command-line> 

Explanation:   The  syntax  of  the  command  line  is  incorrect. 
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VMR  —  Common  block  currently  Installed 

Bxplanatlon:  You  attempted  to  install  a  common  block  that  has 
already  been  Installed. 

VMR  --  Common  block  Is  task  partition  <commonname> 

Explanation t  A  task's  request  for  access  to  a  common  block  has 
been  rejected  because  the  requested  partition  is  a  task 
part*  '■.ion. 

VMR  —  Common  block  not  loaded  <commonname> 

Bxplanation:  The  common  block  specified  by  VMR  in  the  error 
message  has  been  linked  to  the  task,  but  the  common  block  has  not 
yet  been  installed. 

Oser  Action:  The  common  block  must  be  installed  before  the  task 
can  be  installed. 

VMR  —  Common  block  occupied 

Explanation:  You  cittempted  to  install  a  task  in  a  common  block 
that  was  already  occupied. 

VMR  —  Common  block  parameter  mismatch  <commonname> 

Bxplanation:  The  parameters  of  the  common  block  named  in  the 
error  message  do  not  match  the  parameters  in  the  label  block  of 
the  task  that  references  the  common  block. 

VMR  —  Common  block  segment  count  error 

Bxplanation:  You  attempted  to  install  a  resident  library  with 
overlays,  but  the  number  of  overlay  segments  in  the  task  header 
differs  from  the  number  specified  in  the  segment  descriptors. 

VMR  —  CTB  <name>  does  not  exist 

Bxplanation:  The  Controller  Table  name  that  you  specified  with 
the  LOAD  /CTB  keyword  does  not  exist  in  the  resident  data  base. 

VMR  —  CTB  name  <name>  is  a  duplicate 

Explanation:  The  loadable  data  base  contains  a  Controller  Table 
(CTB)  with  a  name  that  is  the  same  as  a  CTB  name  in  the  resident 
data  base.   CTB  names  must  be  unique. 

VMR  —  CTB  <name>  not  supported  by  driver  —  not  loaded 

Explanation:  This  is  a  warning  message.  Two  things  could  be  at 
fault: 

1.  The  Driver  Dispatch  Table  in  the  driver  does  not  have 
all  the  Controller  Table  mnemonics  that  the  rest  of  the 
data  base  (that  is,  DCBs  and  CTBs)  implies  that  it 
should  have. 

2.  The  CTB  is  defective.  A  defective  CTB  may  contain  a 
wrong  name  or  it  may  point  at  the  wrong  DCB. 


• 
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VMR  —  Data  spac*  file  exceeds  available  space  in  system  image 

Ixplanation:  The  RSXllM.SYS  files  are  not  large  enough  to 
contain  the  data  apace  file  DSPllM.SYS. 

VMR  —  DCB  table  for  CTB  <name>  is  full 

Explanation:  LOAD  attempted  to  write  the  address  of  the  Device 
Control  Block  (DCB)  of  the  loadable  data  base  into  the  DCB  table 
of  the  Controller  Table  for  a  mult icontrol ler  device.  There  were 
no  null  entries  in  the  DCB  table.  (See  the  RSX-llM-PLUS  Guide  to 
Writing  an  I/O  Driver . ) 

VMR  —  Device  <ddnn:>  is  attached 

Explanation:  You  attempted  to  unload  a  driver  that   has   one   or 

more   of   its  device  units  attached.   The  first  attached  unit  is 

ddnn:.  You  cannot  unload  a  driver  that  has  device  units 
attached . 

VMR  —  Device  <ddnn:>  is  not  in  system 

Explanation:   This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  save  an  image  on  a  device  that  does  not 
exist  ''"  che  host  system. 

2.  You  attempted  to  redirect  I/O  requests  to  a  device  that 
does  not  exist  on  the  host  system. 

3.  You  specified  a  device  in  the  LOAD  command  line  for 
which  there  is  no  data  base.  This  is  caused  by  one  of 
two  conditions: 

a.  The  device  does  not  exist  in  the  system  device 
tables. 

b.  You  did  not  declare  the  device  to  be  loadable  and 
therefore  LOAD  cannot  find  a  loadable  data  base  for 
it. 

4.  You  specified  a  device  in  the  command  line  that  has  not 
been  defined  in  the  system  image. 

5.  You  specified  a  device  in  the  DEVICES  command  line  that 
does  not  exist  in  the  system  image. 

VMR  —  Device  not  mounted 

Explanation:  You  did  not  mount  the  device  that  contains  the 
system  image  file. 

VMR  —  Device  not  redirectable 

Explanation:  You  attempted  to  redirect  a  device  that  is  marked 
(in  its  UCB)  as  not  redirectable. 

VMR  —  Device  not  terminal 

Explanation:  You  attempted  to  set  terminal  characteristics  for  a 
device  that  is  not  a  terminal. 
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VMR  —  Davice  not  variable  speed  multiplexer 

Kxplanatlon:  You  attempted  to  net  the  baud  rate  for  a  terminal 
that  is  not  attached  to  a  OHll,  DHVll,  OZll,  or  DZVll 
multiplexer . 

VMR  —  Directive  common  already  loaded 

Eiplanation:  You  attempted  to  fix  in  the  RSX-llM-PLUS  system 
image  a  directive  cciiunon  that  is  already  fixed. 

VMR  —  Directive  common  not  contiguous  to  DIRllM 

Explanation:  Directive  commons  must  be  loaded  contiguous  to 
DIRllM  to  work. 

VMR  —  Directive  common (s)  not  fixed  in  memory 

Explanation:  Not  all  of  the  directive  commons  that  were 
installed  in  the  RSX-llM-PLUS  system  image  have  been  fixed. 

VMR  —  Driver  already  resident 

Explanation:  You  attempted  to  load  a  device  driver  that  is 
already  loaded  or  that  is  permanently  resident  in  the  system 
image. 

VMR  —  Driver  built  with  wrong  STB  file 

Explanation:  The  symbol  definition  file  for  the  driver  you 
attempted  to  load  is  not  compatible  with  the  Executive  symbol 
definition  file  for  the  current  system  image.  This  means  that 
the  driver  has  been  built  for  another  system  and  must  be  rebuilt 
before  you  can  load  it  into  the  current  system. 

Explanation:  The  symbol  definition  file  for  the  driver  you 
attempted  to  unload  is  not  compatible  ^th  the  symbol  definition 
file  of  the  current  Executive. 

VMR  —  Driver  cannot  be  unloaded 

Explanation:  You  attempted  to  unload  a  permanently  resident 
driver  (that  is,  a  driver  linked  permanently  to  the  Executive). 

VMR  —  Driver  dispatch  table  is  inconsistent 

Explanation:  You  attempted  to  load  a  driver  whose  driver 
dispatch  table  is  illegally  formatted.  See  the  RSX-llM  or 
RSX-llM-PLOS  Guide  to  Wr i t i ng  an  I/O  Driver. 

VMR  —  Driver  not  loaded 

Explanation:  You  specified  a  driver  in  the  UNLOAD  command  line 
that  is  not  resident  in  memory. 

VMR  —  Driver  requires  running  system  for  LOAd/UNLoad 

Explanation:  The  driver  you  requested  has  the  symbols  $ddLOA  or 
$ddUNL  in  its  source.  Support  of  driver  load/unload  calls  can 
only  be  provided  by  the  MCR  LOAD/UNLOAD  commands. 
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VMR  —  Ex*cutiv*  common  partition  •liminated 

Explanation:  This  Is  a  warning  message.  One  of  the  executive 
common  partitions  has  been  removed.  A  system  generated  with 
executive  common  support  must  have  both  partitions  installed  to 
run . 

VMR  —  Executive  common (s)  not  installed 

Explanation:  This  is  a  warning  message.  For  a  system  generated 
with  executive  common  support,  you  should  install  one  (or  both) 
of  the  commons  before  you  exit  VMR.  Otherwise,  the  system  is 
unusable . 

VMR  —  Executive  too  large 

Explanation:  The  Executive  is  too  large  to  be  accommodated  in 
the  system  image.  This  message  indicates  that  the  Executive  Is 
larger  than  20K.   The  system  is  unusable. 

VMR  --  Extei  nal  headers  not  supported 

Explanation:  You  attempted  to  install  a  task  built  with  external 
headers  in  a  system  that  was  not  generated  with  external  header 
support . 

VMR  —  Feature  not  supported  in  system  image 

Explanation:  You  either  attempted  to  create  secondary  pool  in  a 
system  that  does  not  support  it,  or  you  attempted  to  set  a  device 
public  in  a  system  that  does  not  support  multiuser  protection,  or 
you  attempted  to  enable/disable  the  broadcast  option  for  a 
terminal,  but  the  system  is  not  a  multiuser/multi-CLI  system. 

VMR  —  File  <name>  has  illegal  format 

Explanation:  The  driver's  symbol  definition  file  contains 
illegal  object  code  or  data. 

VMR  —  File  <name>  has  inconsistent  data 

Explanation:   This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  fix  a  partition  or  a  task  that  is 
logically  beyond  the  end  of  the  system  image  file. 

2.  The  partition  for  loadable  drivers  is  logically  beyond 
the  end  of  the  system  image  file.  The  system  image  is 
probably  corrupt. 

3.  The  partition  of  the  common  library  you  are  attempting 
to  load  is  logically  beyond  the  end  of  the  system  image 
file. 

VMR  —  File  <name>  not  a  valid  driver  task  image 

Explanation:   One  of  three  things  has  occurred: 

1.  The  driver's  task  image  has  been  overlaid. 

2.  The  driver  has  a  header. 

3.  The  driver  has  referenced  a  resident  library. 
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VMR  --  Pile  not  contiguous 

Explanation:   This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  install  a   task   from  a   noncontiguous 
file.   Task  images  must  be  contiguous  files. 

2.  The  file  ddDRV.TSK  is  not  contiguous.   This  file  must  be 
contiguous  for  a  device  driver  to  be  loaded. 

VMR  --  File  not  found 

Explanation:  You  requested  a  file  that  is  not  in  the  directory 
of  the  volume  you  specified. 

VMR  —  File  not  task  image 

Explanation:  The  data  in  the  label  block  of  the  task  you  tried 
to  install  is  incorrect,  indicating  that  the  file  is  not  a  task 
image . 

VMR  —  Illegal  device/volume 

Explanation:  You  attempted  to  save  your  system  image  on  an 
invalid  device.   Valid  devices  are: 

CT:  Tape  cassette 

DD:  TU58  DECtape  II 

DT:  DECtape 

DU:  RX50  flexible  disk/RA6C  disk/RC25  disk  (removable) 

DX:  RXOl  flexible  disk 

DY:  RX02  flexible  disk 

MM:  TE/TU16/TU45/TU77  magnetic  tape 

MS:  TS11/TSV05/TU80  magnetic  tape 

MT:  TE/TU10/TS03  magnetic  tape 

PP:  Paper  tape 

VMR  —  Illegal  driver  task  APR  usage 

Explanation:  The  device  driver  being  loaded  must  be  built  for 
APR  5  and  must  be  less  than  4K  words. 

VMR  —  Illegal   r.or  severity  code  <code> 

Bxplanatioi.:  This  message  indica.es  an  internal  failure  in  VMR. 
If  this  error  message  persists,  contact  a  DIGITAL  software 
representative. 

VMR  —  Illegal  file  specification  <filespec> 

Explanation:  The  file  specification  printed  following  the  error 
message  has  an  illegal  format  or  contains  wildcards. 
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VMR  --  Illagal  first  APR 

Biplnnation:  The  task  you  tried  to  install  was  built  osin'^  an 
incorrect  base  APR.   The  following  rules  apply: 

1.  A  nonpr ivileged  task  must  b«  built  with  APR  0  as  its 
base  APR. 

2.  A  privileg'^1  task  that  does  not  map  into  the  Executi"e 
must  be  built  with  APR  0  as  its  base  APR. 

3.  If  the  Executive  is  16K  words  or  less,  a  privileged  task 
that  is  to  map  to  tha  Executive  routines  and  data 
structures  must  be  built  with  APR  4  as  its  base  APR. 

4.  If  the  Executive  is  20K  vi^rds  (or  less  on  RSX-lIM 
systems),  a  privileged  task  that  is  to  map  to  the 
Executive  routines  and  data  structures  must  be  built 
with  APR  5  as  its  base  APR. 

VMR  --  Illegal  function 

Explanation:  You  entered  a  command  that  VMR  does  not  recognize, 
or  the  command  line  refers  to  a  feature  that  is  not  supported  in 
the  system. 

VMR  —  Illegal  Get  Command  Line  <error  code> 

Explanation:  This  message  indicates  a  system  failure.  If  the 
error  persists,  contact  a  DIGITAL  software  representative. 

VMR  —  Illegal  keyword  value 

Explanation:  You  entered  a  value  for  a  keyword  that  is  out  of 
range. 

VMR  —  Illegal  operation  for  unmapped  system 

Explanation:  The  SET  /POOLSIZE  keyword  is  valid  only  on  mapped 
systems . 

VMR  —  Illegal  parameter  for  executive  common  partition 

Explanation:  You  specified  a  parameter  with  SET  /MAIN  that  is 
illegal  for  an  executive  common.  The  partition  size  must  be 
200(8)  and  the  partition  type  must  be  COM. 

VMR  ~  Illegal  priority 

Explanation:  You  specifiec*  a  priority  for  the  taak  being 
installed  that  is  out  cf  range  (that  is,  not  1  through  250 
decimal )  . 

VMR  ~  Illegal  slave  attribute 

Explanation:  You  attempted  to  install  a  task  with  the  /SLV 
keyword,  but  the  task's  name  is  in  the  form  ...xxx.  The  task  is 
a  prototype  task  and  cannot  be  installed  as  a  slaved  task. 

VMR  —  Illegal  switch  <switch> 

Explanation:  The  switch  following  the  error  message  is  incorrect 
in  the  context  of  the  command  line  ycu  liave  entered. 
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VMR  --  Illegal  use  of  <pname>  partition  or  common 

Explanation:  You  attempted  to  install  task  in  a  CPU  oc 
secondary  pool  partition. 

VMR  --  Illegal  use  of  <pname>  partition  or  region 

Eiplanation:  You  attempted  to  load  a  driver  into  a  common  or 
secondary  pool  partition. 

VMR  —  Illegal  use  of  wildcard 

Explanation;  On  an  unmapped  system,  you  cannot  specify  a 
wildcard  (*)  with  the  following  SET  keywords:  /TOP,  /BOT,  and 
/POOL.  You  also  cannot  use  a  wildcard  for  the  size  parameter  of 
task  partitions. 

VMR  —  Illegal  value  for  symbol  <8ymname>  in  file  <filenanie> 

Explanation:   LOAD  or  UNLOAD  has  determined  that  symbol  <symna'ne> 

in  the  STB  <filename:  has  been  defined  to  uP  illegal  value.   This 

can  occur  for  several  reasons,  some  general  and  some  specific   to 

individual   symbols.  For  example,  most  symbols  generally  cannot 

be  defined  to  zero  or  to  an  odd  number.   A   specific   example   is 

the  symbol  SINTSV,  which  must  not  be  referenced  by  mapped 
loadable  drivers. 

VMR  —  Incorrect  assignment  of  SY:   or  LB: 

Explanation:  This  is  a  warning  message.  The  device  SY:  or  LB: 
is  not  assigned  to  the  same  device  as  the  system  image  file  you 
are  trying  to  work  with  in  VMR. 

VMR  —  Indirect  command  syntax  error  <coitunand-line> 

Explanation:  You  entered  i.t  improper  indirect  command  file 
speci  fi cat ion. 

VMR  —  Indirect  file  depth  exceeded  <command-line> 

Explanation:  You  attempted  to  reference  more  than  two  levels  of 
indirect  command  files. 

VMR  —  Indirect  file  open  failure  <command-l ine> 

Explanation:  The  indirect  command  file  specified  in  the  command 
line  could  not  be  opened. 

VMR  —  Install  device  not  LBO: 

Explanation:  You  attempted  to  install  a  task  from  other  than  the 
boot  device. 

VMR  —  Installed  tasks  or  commons  may  no  longer  fit  in  partition 

Explanation:  You  shortened  a  partition  so  that  the  tasks  and/or 
commons  that  are  installed  in  it  may  no  longer  fit.  This  is  a 
warning  message.  VMR  shortens  the  partition  even  though  this 
situation  exists. 
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VMR  —  Interrupt  vector  already  in  use 

Explanation:  The  interrupt  vector  for  the  driver  being  loaded 
does  not  point  to  one  of  the  nonsense  interrupt  entry  points  in 
the  system  image. 

VMR  —  Invalid  driver  data  base  at  offset  xxxx  in  file  <filename> 

Explanation:  The  driver  name  has  an  invalid  data  base  value  at 
offset  xxxx  relative  to  the  symbol  $udDAT.  (See  the  RSX-llM  or 
RSX-llM-PLUS  Guide  to  Writing  an  I/O  Driver. 

VMR  —  Invalid  interrupt  vector 

Explanation:  You  specified  an  interrupt  vector  address  in  the 
driver  data  base  that  is  too  high  for  the  system  image. 

VMR  —  Invalid  keyword 

Explanation:  You  specified  a  keyword  that  is  incorrect  in  the 
context  of  the  command. 

VMR  —  Invalid  record  address  for  file  <filename> 

Explanation:  LOAD  has  attempted  to  write  outside  of  the  system 
image  file  or  at  a  byte  boundary.   Three  possible  causes  are: 

1.  A  corrupted  system  image 

2.  An  STB  file  that  does  not  match  the  system  image 

3.  An  internal  problem  in  VMR 
VMR  —  Invalid  speed 

Explanation:   This  message  can  occur  for  two  reasons: 

1.  You  requested  a  speed   that   the  multiplexer   line   you 
specified  does  not  support. 

2.  You  specified  unequal  receive  and  transmit  speeds  for   a 
DZll   or   DZVll.   The  DZll  and  DZVll  multiplexers,  do  not   | 
support  split  speeds. 

VMR  —  Invalid  time  parameter 

Explanation:  The  time  field  yo<i  specified  in  the  RUN  command 
line  is  incorrect. 

VMR  ~  Invalid  UIC 

Explanation:  You  specified  an  illegal  value  for  either  a  group 
number  or  a  member  number .  The  numbers  must  be  from  1  through 
377(8)  . 

VMR  —  I/O  error  on  input  file  <filename> 

Explanation:   An  input  I/O  error  occurred  on  the  indicated  file. 

VMR  —  I/O  error  on  output  device 

Explanation:  SAVE  has  encountered  an  I/O  error  on  the  output 
device  while  writing  the  system  image. 
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VMR  —  I/O  •rror  <•   output  flxj  <fil«name> 

Explanation:   An  output  I/O  error  occurred  on  the  Indicated  file. 

VMR  ~  Keyword  not  supported  for  this  terminal  driver 

Explanation:  The  terminal  driver  selected  during  system 
generation  does  not  support  the  specified  SET  keyword.  For 
example,  typeahead  is  a  full-duplex  terminal  driver  option  only 
and  your  system  uses  the  half-duplex  driver. 

VMR  —  KRB  <KRBname>  interrupt  vector  <octal-number>  in  use 

Explanation:  You  attempted  to  load  a  driver  that  specifies  an 
interrupt  vector  that  is  not  pointing  to  a  nonsense  interrupt 
entry  point  address.  This  is  usually  caused  by  a  previously 
loaded  driver  that  has  used  this  vector. 

When  you  get  this  message,  LOAD  has  loaded  the  driver  correctly, 
but  it  has  not  overwritten  the  interrupt  vector. 

VK'-    —  KRB  <KRBname>  interrupt  vector  <octal-number>  too  high 

Explanation:  You  attempted  to  load  a  driver  that  specifies  an 
interrupt  vector  address  that  is  higher  than  the  highest 
permissible  vector  address  in  the  system. 

When  you  get  this  message,  LOAD  has  loaded  the  driver  correctly, 
but  it  has  not  overwritten  the  interrupt  vector. 

VMR  —  KRB  <KRBname>  not  in  loadable  data  base 

Explanation:  You  attempted  to  load  the  driver  for  a 
multicontroller  device  with  a  loadable  data  base.  The  special 
symbol  (KRBname)  that  defines  the  location  of  the  KRB  in  the 
multicontroller  device's  CTB  table  is  not  defined  in  the  loadable 
data  base.   See  the  RSX-llM-PLUS  Guide  to  Writing  an  I/O  Driver . 

VMR  —  KRB  table  of  CTB  <CTBname>  will  not  accept  KRB  <KRBname> 

Explanation:  You  attempted  to  load  the  driver  for  a 
multicontroller  device  with  a  loadable  data  base.  If  this 
operation  is  to  be  successful,  two  conditions  must  exist: 

1.  The  appropriate  slot  in  the  CTB  (Controller  Table)   must 
exist . 

2.  The  slot  in  the  CTB  must  be  unused. 

When  VMR  issues  this  error  message,  one  of  these  conditions  does 
not  exist.   See  the  RSX-llM-PLUS  Guide  to  Writing  an  I/O  Driver. 

VMR  —  Length  mismatch  common  block  <blockname> 

Explanation:  The  length  parameter  for  the  common  block,  as 
described  in  the  label  block  for  the  task  image,  does  not  match 
the  corresponding  length  parameter  defined  in  the  system  image. 
A  task's  label  block  data  must  match  system  data  for  that  task 
before  it  can  be  installed. 
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VMR  --  Lin*  not  DZll 

Explanation:  You  attempted  to  set  a  line  to  remote  that  la  not 
attached  to  a  DZIl,  but  your  syitem  uses  the  half-duplex  terminal 
driver . 

VMR  —  Loadable  driver  larger  than  4K 

Explanation:  This  is  a  warning  message.  You  are  loading  a 
driver  that  is  larger  than  4K  words. 

VMR  —  Loadable  driver  support  not  in  system 

Explanation:  You  attempted  to  load  a  device  into  a  system  imagn 
that  does  not  contain  the  Executive  routine  $INTSI.  The  routine 
is  ne<)ded  to  support  loadable  device  drivers. 

VMR  —  Logical  device  not  in  system 

Explanation:  The  device  you  ipecified  has  not  been  defined  and 
therefore  ASSIGN  could  not  find  it  in  the  logical  device 
assignment  table. 

VMR  --  LUN  out  of  range 

Explanation:  You  attempted  to  reassign  a  LUN  for  a  task  that  is 
higher  than  the  maximum  number  of  LUNs  allocated  for  the  task 
when  it  was  built. 

VMR  —  No  checkpoint  space,  assuming  not  checkpointable 

Explanation:  This  is  a  warning  message.  You  attempted  to 
install  a  task  as  checkpointable  that  was  not  built  as 
checkpointable.  This  means  that  there  is  no  checkpoint  space 
allocated  in  the  task  image  file.  Since  the  system  image  does 
not  support  the  dynamic  allocation  of  checkpoint  space,  INSTALL 
does  not  consider  the  task  to  be  checkpointable. 

VMR  —  No  checkpoint  space  or  dynamic  checkpoint  file 

Explanation:  You  attempted  to  install  a  task  built  with  external 
headers  or  as  checkpointable,  but  the  task  does  not  nave  any 
checkpoint  space  and  the  system  does  not  have  a  checkpoint  file. 

VMR  —  No  LUNs 

Explanation:  The  task  that  you  specified  as  an  argument  of  the 
LUN  command  does  not  have  any  logical  units  assigned  to  it.  This 
is  not  an  error  message;  rather,  it  is  simply  an  indication  that 
there  are  no  assignments  to  display. 

VMR  —  No  pool  space 

Explanation:  The  pool  space  required  to  load  the  driver  is  not 
available  in  the  system  image. 

VMR  —  No  room  available  in  STD  for  new  task 

Explanation:  There  is  no  dynamic  storage  available  to  make  an 
entry  in  the  System  Task  Directory  (STD) .  The  task  cannot  be 
installed. 
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VMR  --  No  tabl*  apace  foe  optional  directive  common 

Kiplanation:  You  attempted  to  fix  a  directive  common  in  the 
RSX-llM-PLUS  system  image,  but  the  extra  slots  built  into  the 
system  data  base  for  unrequired  directive  commons  have  all  been 
used . 

VHR  —  Nonexistent  memory 

Explanation:  You  attempted  to  define  a  partition  in  nonexistent 
memory. 

VMR  —  Not  enough  APRs  for  task  image 

Explanation:  The  Task  Builder  allows  you  to  specify  the  virtual 
base  address  of  a  task  image  as  a  multiple  of  4K.  Privileged 
tasks  that  access  the  Executive  start  at  either  virtual  address 
100000(8)  for  a  16K  Executive  or  at  virtual  address  120000(8)  for 
a  20K  Executive.  If  the  virtual  base  address  of  the  task  is  set 
too  high,  there  are  not  enough  APRs  remaining  to  map  the  task 
image.  (See  the  RSX-llM/M-PLUS  Task  Builder  Manual  for 
information  on  pr i vi leged  tasks  . ) 

VMR  —  Old  device  attached 

Explanation:   You  attempted  to  redirect  an  attached  device. 
VMR  —  Op«n  failure  on  file  <filename> 

Explanation:   The  indicated  file  cannot  be  opened. 
VMR  —  Operation  cannot  extend  above  first  124. K  of  memory 

This  message  can  occur  for  the  following  reasons: 

1.  On  RSX-llM,  you  attempted  to  fix  a  task  above  124K 
words.  The  largest  system  that  can  be  saved  is  124K 
words.  If  FIX  allowed  you  to  fix  a  task  above  this 
limit,  the  task  would  be  lost  when  the  system  was  saved. 

2.  You  attempted  to  create  with  the  SET  command  a  CPU 
partition  whose  upper  limit  is  above  124K  words. 

VMR  —  Operation  not  allowed  for  <ptype>  partitions 

Explanation:  You  attempted  a  SET  operation  that  is  not  allowed 
for  the  type  of  partition  specified  in  the  error  message. 

VMR  --  Optional  directive  common  successfully  loaded 

Explanation:  VMR  has  successfully  fixed  in  the  system  image  a 
directive  common  that  is  not  one  of  the  commons  required  by 
RSX-llM-PLUS  (DIRllM  and  DR211M) . 

VMR  —  Partition  already  exists 

Explanation:   This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  define  a  partition,  using  the  SET 
command,  with  a  name  already  in  use  as  a  partition  name. 

2.  You  attempted  to  define  a  subpartition,  using  the  SET 
command,  but  there  are  no  more  subpartition  slots 
available. 
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VMR  —  Partition  or  common  region  is  busy 

Biplanation:   This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  fix  a  task  or  common  region  in  a 
partition  that  is  full.  The  task  or  legion  cannot  be 
fixed. 

2.  You  attempted  to  load  a  device  driver  into  a  partition, 
but  the  partition  is  full. 

3.  You  attempted  to  remove  a  partition  that  still  ban  tasks 
installed  in  it.   The  partition  cannot  be  removed. 

VMR  —  Partition  <pname>  is  a  common 

Explanation:  You  attempted  to  load  a  device  driver  into  a  common 
partition.   This  cannot  be  done. 

VMR  —  Partition  <pname>  is  not  a  common 

Explanation:  Partition  <pname>  was  found,  but  it  is  not  a  common 
partition. 

VMR  —  Partition  <pname>  is  too  small 

"Explanation:  You  attempted  to  load  the  driver  into  a  partition 
that  is  either  too  small  for  the  driver  or  that  does  not 
currently  have  enough  space  for  the  driver.  Or,  you  attempted  to 
install  a  task  that  is  too  large  for  the  specified  partition. 

VMR  —  Partition  <pname>  not  in  system 

Explanation:   This  message  can  occur  for  the  following  reasons: 

1.  The  partition  you  specified  in  the  command  line  is  not 
in  the  system  image. 

2.  You  attempted  to  load  a  driver  into  a  partition  that 
does  not  exist  in  the  system,  or  LOAD  found  a  symbol 
$xxCOM  in  the  driver  and  partition  xxCOM  does  not  exist 
in  the  system. 

VMR  —  Partition  <pname>  not  in  system,  defaulting  to  GEN 

Explanation:  This  is  a  warning  message.  You  attempted  to 
install  a  task  in  a  partition  that  does  not  exist,  vmr  will  try 
to  install  the  task  in  the  partition  GEN. 

VMR  --  Partition  not  s-'stem  controlled 

Explanation:  The  SET  command  keywords  /TOP  and  /BOT  are  valid 
only  for  system-controlled  partitions. 

VMR  —  Partition  reduced  to  executive  common  size 

Explanation:   This   is   an   informational    message.     When  an 

executive   common  is  installed  in  its  partitj  n,  the  partition  is 

reduced  to  the  top  of  the  common  to  eliminate  c-<y  unused  space  in 
the  partition. 
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VMR  —  Privileged  task  overmaps  I/O  pago 

Explanation:  This  message  pertains  to  tho  installation  of  a 
privileged  task. 

A  privileged  task  that  is  mapped  into  the  Executive  is  often 
mapped  to  the  I/O  page  as  well.  However,  many  privileged  tasks 
do  not  require  access  to  the  I/O  page  and  can  use  the  extra  4K  of 
address  space  that  would  be  allocated  to  the  I/O  page  for  the 
task  itr.age.  This  message  warns  that  a  privileged  task  that  may 
require  access  to  the  I/O  page  doe j  not  have  that  access.  If  the 
task  does  not  require  access  to  the  I/O  page,  this  message  can  be 
igno  ?d . 

VMR  —  Privileged  task  larger  than  12K 

Explanation:  You  attempted  to  install  a  privileged  task  that  is 
xarger  than  12K  words.  (See  the  RSX-llM/M-PLUS  Task  Builder 
Manual  for  information  on  privileged  tasks .) 

VMR  —  Pool  link  error  at  xxxx  Block=yyyy  zzzz 

Explanation:  When  SET  /POOL  traced  the  pool  linkage,  it  detected 
an  error  at  location  xxxx  in  the  system  image.  The  contents  of 
xxxx  is  yyyy  and  the  contents  of  xxxx+2  is  zzzz. 

VMR  --  Pseudo  device  assignment  error 

Explanation:  You  attempted  to  assign  a  logical  device  name  to  a 
pseudo  device.  Logical  device  names  cannot  be  assigned  to  pseudo 
devices . 

VMR  —  Pseudo  device  redirect  error 

Explanation:  You  attempted  to  redirect  one  pseudo  device  to 
another  pseudo  device.   This  is  not  allowed. 

/MR  —  R/0  partition  <pname>  not  in  system,  defaulting  to  task's 

Explanation:  You  specified  a  read-only  partition  that  does  not 
exist  in  the  system.  INSTALL  will  place  the  read-only  portion  of 
your  multiuser  task  into  the  same  partition  as  the  read/write 
portion  of  the  task. 

VMR  —  Receive  data  or  by  reference  list  not  empty 

Explanation:  A  task  with  entries  in  its  receive  queues  cannot  be 
removed  from  the  system  image. 

VMR  —  Space  used 

Explanation:  You  attempted  to  create  a  partition  in  a  storage 
area  that  is  already  occupied. 

VMR  —  Specified  partition  for  common  block 

Explanation:   You  attempted  to  install  a  task  in  ■^   common  block. 


• 
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VMR  —  Specified  partition  too  small 

Explanation!   This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  install  a  task  into  a  partition  that  is 
smaller  than  the  task. 

2.  You  attempted  to  install  a  driver  into  a  partition  that 
is  smaller  than  the  driver. 

VMR  —  Symbol  <symname>  is  doubly  defined  by  file  <filenaroe> 

Explanation:  The  symbol  symname  is  defined  twice  in  the 
specified  file.  Duplicate  symbols  are  illegal.  The  driver  is 
not  loaded  or  unloaded. 

VMR  —  Symbol  <symname>  is  undefined  in  file  <filename> 

Explanation:  LOAD  found  the  symbol  symname  in  the  specified 
file,  but  the  symbol  is  not  defined. 

VMR  —  Syntax  error 

Explanation:   You  have  typed  the  command  line  incorrectly. 

VMR  —  System  rmage  is  not  RSX-llM-PLUS 

Explanation:  You  attempted  to  use  RSX-llM-PLUS  VMR  on  a 
iion-RSX-llM-PLUS  system  image  file. 

VM^  —  System  image  is  RSX-llM-PLUS 

Explanation:  You  attempted  to  use  RSX-llM  VMR  on  an  RSX-llM-PLUS 
system  image  file. 

VMR  —  Tack  active 

Explanation:  The  task  you  specified  as  an  argument  of  the 
command  is  active. 

VMR  —  Task  and  partition  bases  mismatch 

Explanation:  The  base  of  the  partition  does  not  match  that  of 
the  task  being  installed  or  of  the  driver  being  loaded.  This 
message  applies  only  to  unmapped  systems. 

VMR  —  Task  or  common  region  already  fixed 

Explanation:  You  attempted  to  fix  a  task  or  common  region  in 
memory  that  is  already  fixed. 

VMR  —  Task  has  attached  comiTion  regions 

Explanation:   This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  fix  or  unfix  a  task  in  memory  that  is 
linked  to  a  shared  region.  VMR  cannot  fix  or  unfix  such 
tasks. 

2.  You  attempted  to  reir  a  task  that  is  linked  to  a 
shared  region  from  tnu  system  image.  VMR  cannot  remove 
such  tasks. 
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VMR  —  Task  image  currently  installed 

Biplanationt  You  attempted  to  install  a  checkpointable  task  that 
has  checkpoint  space  allocated  in  its  task  image.  The  task  has 
already  been  installed. 

The  system  allows  you  to  install  checkpointable  tasks  more  than 
once  subject  to  the  following  rules: 

1.  You  must  allocate  checkpoint  space  for   the   task   in   a 
system  checkpoint  file,  or 

2.  You  must  use  a  different  name  for  the  task  each  time  you 
install  it. 

VMR  —  Task  image  I/O  error 

Explanation:  The  task  cannot  be  installed  or  the  driver  cannot 
be  loaded.  VMR  could  not  read  the  task  image  file  or  could  not 
rewrite  the  task  image  header.  The  specified  device  may  be 
write-locked. 

VMR  —  Task  image  virtual  address  overlaps  common  block  <blockname> 

Explanation:  The  virtual  addresses  you  reserved  for  the  task 
image  overlap  those  you  reserved  for  the  common  block  specified 
in  the  error  message.  Corruption  of  the  task  image  file  may  have 
caused  the  overlap. 

VMR  —  Task  is  checkpointable 

Explanation:  You  attempted  to  fix  a  checkpointable  task  in 
memory.   Checkpointable  tasks  cannot  be  fixed. 

VMR  —  Task  is  not  multi-user 

Explanation:  You  attempted  to  fix  in  memory  the  read-only 
portion  of  a  multiuser  task,  but  the  task  you  named  in  the 
command  line  is  not  a  multiuser  task. 

VMR  —  Task  name  already  in  use 

Explanation:  You  attempted  to  install  a  task  of  the  same  name  as 
that  of  one  already  installed  in  the  system  image. 

VMR  —  Task  not  installed  with  external  header 

ExplanatiOii:  This  is  a  warning  message  to  indicate  that  the 
specified  task  is  installed  with  its  header  in  pool  (the  dynamic 
storage  region) . 

VHR  —  Task  not  in  system 

Explanation:  You  referenced  a  task  that  is  not  installed  in  the 
system. 

V'lR  —  Task  not  removed,  CLI  has  messages  enabled 

Explanation:  You  attempted  to  remove  a  CLI  task  that  is  able  to 
receive  messages  from  the  system.  The  task  may  have  messages 
that  it  has  not  received  yet,  so  the  remove  request  is  aborted. 
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VMR  —  Task  or  common  not  in  memory 

Explanation:  You  attempted  to  remove  a  task  or  common  from  the 
system  that  is  checkpointed  and,  therefore,  not  in  memory. 

VMR  —  Task  or  common  region  is  not  fixed 

Explanation:  You  attempted  to  unfix  a  task  that  is  not  fixed  in 
the  system  image. 

VMR  —  Task  or  common  region  not  in  system 

Explanation:  You  referenced  a  task  or  common  region  that  has  not 
been  installed  in  the  system  or,  on  RSX-llM-PLUS,  you  attempted 
to  run  a  prototype  task. 

VMP  —  Task  requires  system  contrr>lled  partition 

Explanation:  You  attempted  to  install  a  task  that  was  built  with 
external  header  (/XH)  support  and  as  checkpointable  (TKB  /CP,  INS 
/CKP=YES) .  Such  tasks  must  be  installed  in  a  system-controlled 
partition. 

VMR  —  TI  redirect  error 

Explanation:  You  attempted  to  redirect  the  pseudo  device  TI:. 
TI :   cannot  be  redirected. 

VMR  —  TT  redirect  error 

Explat..'^.tion:  You  attempted  to  redirect  a  terminal  to  the  null 
device.   This  combination  is  not  allowed. 

VMR  —  Too  many  common  block  requests 

Explanation:  You  attempted  to  install  a  task  that  contains  too 
many  common  block  requests.  A  task  is  limited  to  seven  common 
block  references. 

VMR  —  Too  many  LUNs 

Explanation:  You  attempted  to  install  a  task  that  contains  more 
than  250(10)  LUN  assignment  requests. 

VMR  —  Too  many  symbols  of  the  form  $xxTMO  in  file  name 

Explanation:  LOAD  is  attempting  to  extract  symbols  of  the  form 
$xxTMO  from  the  driver's  symbol  definition  file.  There  are  more 
symbols  of  this  form  than  LOAD  can  process. 

VMR  —  Top  of  pool  set  to  <value>,  requested  amount  not  available 

Explanation:  You  requested  more  pool  space  than  the  system  can 
provide.   The  system  provides  as  much  as  possible  in  this  case. 

VMR  —  Undefined  common  block  <blockname> 

Explanation:  You  attempted  to  install  a  task  that  references  a 
common  block  that  is  not  defined  in  the  system  image.  This 
message  may  indicate  that  the  task  was  built  for  another  system. 

VMR  —  Unknown  partition 

Explanation:  You  attempted  an  operation  on  a  partition  that  does 
not  exist  in  the  system. 
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VMR  —  User  D-space  not  supported 

Rxplanation:  An  attempt  was  made  to  install  a  task  with  separate 
instruction  and  data  space  on  a  system  that  does  not  support  user 
D-space.   (User  D-space  is  a  system  generation  option.) 

VMR  —  Virtual  terminal  error 

Explanation:  You  attempted  to  enable,  using  the  SET  command,  a 
terminal  option  for  a  virtual  terminal. 

VMR  —  Write  check  not  supported  for  device 

Explanation:  You  attempted  to  enable  write  checking  for  a  device 
that  does  not  support  it.  Write  checking  is  supported  for  all 
disks  except  RLOls  and  RL02s  (DL:)  and  RXOls  (DX:). 
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CHAPTER  11 
COMMAND  LINE  INTERPRETERS 


11.1   INITIAL  CONCEPTS 

A  command  line  interpreter,  or  CLI,  is  a  task  that  services 
unsolicited  commands  meant  for  the  operating  system  or  an  application. 
These  commands  are  not  prompted  for  by  any  task  nor  are  they  given  to 
a  task  by  a  read  operation  on  a  terminal. 

The  best-known  CLI  on  RSX-llM/M-PLUS  systems  is  MCR,  which  controls 
the  operating  system.  MCR,  like  any  other  CLI,  receivss  command  lines 
that  originate  as  unsolicited  input  typed  on  a  terminal  or  as  issued 
by  a  task  using  an  Executive  directive.  Since  all  lines  typed  on  a 
terminal  are  seen  by  the  CLI  (except  those  used  to  satisfy  a  task's 
fad  requests),  the  CLI  task  is,  in  effect,  a  complete  user  interface. 
This  control  over  the  user  at  the  terminal  is  absolute.  There  is  no 
way  to  bypass  a  CLI  to  send  commands  to  the  system  or  application. 

A  CLI  is  also  an  efficient  means  o£  interfacing  an  application  command 
processor  to  any  number  of  terminals,  since  no  read  QIC  or  character 
AST  processing  is  involved.  The  input  from  the  terminal  simply  goes 
to  the  CLI  by  default  for  processing. 

This  chapter  introduces  the  concepts  of  CLIs  on  RSX-llM/M-PLUS 
systems.  The  chapter  provides  enough  information  to  allow  a 
programmer  to  write  application-specific  CLIs.  A  brief  description  of 
three  DIGITAL  CLIs  supplied  with  the  system  illustrates  these 
concepts.  These  three  system  CLIs  do  quite  different  things  with  the 
command  lines  they  process,  but  the  basic  goal  of  each  is  the  same: 
to  provide  a  specific  environment  for  the  terminal  user.  This  basic 
goal  also  applies  to  any  application-specific  CLIs,  which,  of  course, 
may  perform  completely  different  command  processing  functions.  A 
simple  sample  CLI  -  written  in  both  FORTRAN  and  MACRO-11  -  is  included 
in  this  chapter.  The  example  is  also  included  on  the  distribution  kit 
in  either  LB:  [1,2]  with  the  HELP  files  or  in  the  new-user  account 
[200,1]  as  TMCLI.MAC  and  TMCLI.FTN.  See  your  system  manager  for  more 
information.  The  example  illustrates  the  CLI  interface  and  should 
clarify  the  basic  operations  of  a  CLI. 

NOTE 

This  chapter  describes  features 
available  on  RSX-llM  and  RSX-llM-PLUS. 
RSX-llS  systems  include  Basic  MCR,  but 
do  not  support  the  CLI  features 
discussed  in  this  chapter. 
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11.1.1   MCR  -  The  Traditional  RSX-llM/M-PLUS  CLI 

The  most  important  CLI  on  RSX-llM/M-PLUS  systems  is  MCR.  MCR  receives 
commands  from  the  terminal  and  executes  them  to  control  the  system. 
MCR  is  a  set  of  privileged  tasks.  These  tasks  call  Executive  routines 
and  interact  v;}  ;  h  the  system's  data  base.  Therefore,  MCR  is  tied  very 
closely  to  the  Executive.  This  bond  is  necessary  because  of  MCR's 
function  in  system  control  and  has  nothing  to  do  with  MCR's  role  as  a 
CLI. 

Most  other  CLIs  interact  with  an  application  running  on  the  system, 
rather  than  with  the  system  itself.  Therefore  the  CLI  designer  need 
not  have  any  knowledge  of  RSX-llM/M-PLUS  internals.  In  fact,  the 
resulting  CLI  need  not  even  be  privileged.  The  only  similarity 
between  MCR  and  other  CLIs  is  that  any  CLI  controls  the  terminals 
associated  with  it  just  as  MCR  does.  Every  terminal  on  an 
RSX-llM/M-PL'JS  system  is  set  to  some  CLI.  Users  can  do  nothing  on 
their  terminals  that  their  CLI  does  not  permit.  The  CLI  controls  the 
use  of  the  terminal. 

NOTE 

While  MCR  is  a  CLI,  it  is  a  special  CLI. 
MCR  does  not  'ise  the  CLI  interface 
'  directives  because  it  must  work  on 
systems  that  do  not  support  these 
directives.  Therefore,  MCR  is  not  a 
pattern  for  other  RSX-llM/M-PLUS  CLIs. 


11.1.2  DCL  -  DIGITAL  Command  Language 

The  DIGITAL  Command  Language  (DCL)  interpreter  is  a  CLI  that  does  not 
actually  execute  any  commands.  DCL  provides  an  interface  to  operating 
system  features  by  translating  the  commands  it  receives  in  DCL  syntax 
to  the  equivalent  MCR  commands.  DCL  then  passes  the  translated 
command  line  to  the  appropriate  MCR  task  or  utility  for  execution. 
The  CLI  interface  hides  this  operation  from  the  user  at  the  terminal, 
who  does  not  need  to  know  about  MCR  or  the  utilities.  DCL  is  oriented 
tOvvards  operations,  such  as  COPY  or  LINK,  rather  than  towards  tasks 
likif  PIP  and  TKB.  DCL  presents  a  totally  different  external  interface 
to  RSX-llM/M-PLUS,  one  that  is  easier  to  learn  and  use  than  MCR.  This 
makes  it  possible  for  less  technical  users  to  do  work  on 
RSX-llM/M-PLUS. 


11.1.3   RMT  -  DECnet  Remote  Terminal  Facility 

The  RMT  tasl;  is  a  CLI  that  gathers  commands  from  the  terminals 
associater'  with  it  and  sends  them  over  a  DECnet  network  to  be  executed 
on  a  remote  RSX-llM/M-PLUS  system.  The  RMT  interface  provides  a 
mechanism  for  command  handling  with  a  minimum  of  overhead  or  effect  on 
user  tasks.  RMT  is  different  from  DCL:  RMT  does  not  interpret  the 
command  strings  it  handles,  while  all  DCL  does  is  interpret  strings. 
All  the  interpretation  and  execution  of  commands  passed  through  RMT  is 
done  by  the  CLI  that  receives  the  commands  on  the  remote  system. 
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11.2   WRITING  AN  APPLICATION  CLI 

A  CLI  Is  an  RS> -IIM/M-PLUS  task  like  any  other.  It  need  not  oe 
privileged,  unless  the  application  requires  it.  Any  alternate  CLI  is 
expected  to  interact  with  the  operating  system  in  a  certain  way, 
however.  This  is  necessary  to  synchronize  with  the  operating  system 
in  command  handling  and  prompting.  This  Interaction  is  achieved 
through  a  set  of  Executive  directives  for  CLIs. 


11.2.1   Executive  Directives  for  CLIs 

The  Most  important  directive  is  GCCIS  (Get  Command  for  Command 
Interpreter).  GCCIS  must  be  used  by  every  CLI,  no  matter  what  the  CLT 
does.  GCCIS  supplies  a  command  to  the  CLI  from  a  queue  maintained  by 
the  system.  It  also  controls  the  internal  status  bits  necessary  for 
correct  synchronization  of  prompting  and  general  command  handling  in  a 
manner  transparent  to  the  CLI  task. 

Other  CLI  directives  include: 

1.  RPOI$  (Request  and  Pass  Offspring  Information)  and  SDRP$ 
'Send,  Request,  and  Pass),  which  can  be  used  to  pass  the 
responsibility  for  handing  a  command  off  to  another  task  so 
the  CLI  is  free  to  handle  another  command. 

2.  SCAA$  (Specify  Command  Arrival  AST),  which  specifies  an  AST 
in  the  CLI  whenever  a  command  arrives  for  processing  by  the 
CLI. 

3.  GCIIS  (Get  Command  Interpreter  Information),  which  returns 
info-'mation  about  a  terminal  or  CLI  to  the  task. 

See  the  RSX-1 IM/M-PLUS  Executive  Reference  Manual  for  a  complete 
description  of  these  directives. 


11.2.2  Basic  Interaction  with  the  Operating  System 

Before  a  CLI  can  process  commands,  it  must  be  made  known  to  the 
system.  This  is  done  by  installing  the  CLI  task  with  the  /CLI=YES 
switch  and  then  initializing  the  CLI  with  the  CLI  /INIT  command.  This 
process  creates  an  internal  data  structure  that  allows  the  system  to 
recognize  the  existence  of  the  CLI.  See  the  RSX-1 IM/M-PLUS  MCR 
Operations  Manual  for  a  description  of  the  INSTALL  command  and  tlTe  CLI 
commands. 

A  CLI's  operation  starts  when  a  command  is  entered  into  the  system. 
The  command  may  originate  as  a  command  line  typed  on  a  terminal  or 
from  an  Executive  directive  issued  by  a  task.  The  source  of  the 
command  is  generally  irrelevant  to  the  CLI.  The  command  is  processed 
first  by  the  system  command  dispatcher  (the  MCR...  task).  This  task 
puts  the  command  into  a  FIFO  queue  of  commands  to  be  retrieved  by  the 
CLI.  The  CLI  associated  with  the  terminal  from  which  the  command 
originated  is  then  requested  to  run  (or  unstopped  if  it  is  already 
active)  .  The  CLI  gets  the  command  from  the  system  by  issuing  the 
GCCIS  directive.  This  directive  removes  a  command  from  the  CLI's 
queue  ar.d  copies  it  into  a  buffer  in  the  CLI's  t'lsk  space.  GCCiS  can 
alsc  supply  information  about  the  source  terminal  to  the  Cul. 
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Once  the  CLI  has  the  command,  it  is  free  to  process  it  in  any  manner 
it  chooses.  Generally  this  involves  executing  the  command,  or  passing 
the  command  to  another  task  for  execution.  If  the  CLI  is  going  to 
pass  the  command  to  another  (non-CLI)  task,  it  should  use  the  RPOI$  or 
SDRP$  directive  to  do  this,  assuming  the  CLI  has  no  further  interest 
in  the  command.  These  directives  propagate  the  information  the  system 
needs  for  controlling,  prompting  and  getting  exit  status  back  to  a 
parent  task,  if  any.  The  CLI's  obligations  to  the  command  are 
complete  once  the  command  has  been  passed  off.  There  is  no  reason  for 
the  CLI  to  get  involved  again.  This  is  the  recommended  procedure  for 
handling  commands,  as  it  avoids  the  v/ait  for  the  preceding  command  to 
complete  execution.  DCL  works  in  this  way:  translating  a  command 
into  a  different  format  and  dispatching  it  to  another  task  for 
execution. 

CLIs  that  process  commands  themselves  should  be  very  careful  about 
handling  any  possible  delays  in  execution.  This  is  especially  true  if 
the  CLI  is  to  do  I/O  to  a  terminal;  this  means  any  terminal  I/O, 
including  prompts  for  input.  Otherwise,  it  would  be  very  easy  for  one 
user  to  suspend  command  handling  by  not  responding  to  a  prompt  or  by 
typing  CTRL/S. 

Once  a  CLI  has  completed  processing  a  command,  it  must  reissue  the 
GCCI$  directive  to  get  any  other  command  which  may  have  been  queued  to 
it.  If  the  CLI  wants  to  stop  or  exit  when  no  commands  are  queued  to 
it,  it  should  do  tnis  by  issuing  the  GCCI$  directive  with  the 
appropriate  no-command  action  specified.  This  prevents  a  command 
queued  between  the  return  from  the  GCCI$  and  the  issuance  of  an  EXIT 
or  STOP  directive  from  being  lost,  or  not  processed  until  the  next 
command  is  queued. 


11.2.3  T&sk  Names  for  CLIs 

CLIs  can  be  installed  with  task  names  in  the  form  ...xxx  (commonly 
called  a  prototype  task  name)  or  with  names  in  some  other  legal  form, 
such  as  xxxxxx  (commonly  called  a  conventional  task  name) . 

If  the  CLI  has  a  prototype  task  name,  the  system  creates  a  separate 
copy  of  the  CLI  each  time  a  command  is  entered  on  a  terminal  set  to 
that  CLI.  The  task  is  nameo  xxxtnn,  following  the  same  general  rule 
as  any  other  task  installed  in  the  system  with  a  prototype  task  name. 
Each  copy  of  the  CLI  runs  with  the  same  TI:  and  UIC  as  that  of  the 
terminal  the  command  came  from.  These  tasks  should  exit  when  there  is 
no  work  left  for  them  to  do. 

If  the  CLI  has  a  conventional  task  name,  all  commands  t/om  all 
terminals  associated  with  the  CLI  are  queued  to  a  single  copy  of  the 
task.  This  task  runs  with  a  TI :  of  CO:  (console  output  pseudo 
device).  CLIs  with  conver.tional  task  names  must  specify  the  TI:  and 
UIC  fields  in  any  RPOI$  or  srWN$  directives  they  issue,  since  the  t\.2 
TI :  and  UIC  will  not  default  correctly.  Since  there  is  only  one  copy 
of  these  tasks  in  the  system,  CLIs  with  conventional  task  names  can 
simply  stop  rather  than  exiting  when  there  are  no  commands  queued  for 
them.  This  iviay  be  necessary  if  the  CLI  must  maintain  information  from 
one  command  to  the  next. 

DCL  is  installed  with  a  prototype  task  name,  ...DCL.  RMT  is  installed 
as  RMT...,  with  a  conventional  task  name.  The  difference  reflcrcts  the 
use  and  nature  of  each  CLI. 
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DCL  must  be  installed  with  a  task  name  of  ...DCL  because  most  DCL 
commands  issue  prompts  Cor  input.  No  command  processing  can  be  done 
by  DCL  while  it  is  waiting  for  the  user  to  respond  to  a  prompt.  If 
there  were  only  one  copy  of  DCL  on  the  system,  command  processing  for 
all  DCL  terminals  would  stop  while  a  prompt  request  to  any  one 
terminal  is  outstanding.  This  is  clearly  not  an  acceptable  situation. 
Giving  each  terminal  its  own  copy  of  DCL  allows  independent  command 
processing  for  each  terminal.  To  avoid  filling  the  system  with  copies 
of  DCL,  the  individual  copies  of  the  task  exit  when  no  commands  are 
left  for  them.  They  can  do  this  since  there  is  no  need  to  maintain 
any  context  between  commands. 

On  the  other  hand,  RMT  is  installed  as  RMT. . .  because  there  can  only 
be  one  copy  of  RMT  in  the  system.  This  is  because  RMT  provides  a 
focal  point  with  which  the  DECnet  command  handling  software  running  on 
the  remote  system  can  communicate.  Furthermore,  it  is  not  practical 
to  have  RMT  exit  when  no  commands  are  outstanding  since  it  is 
necessary  to  maintain  context  between  commands.  If  each  user  got  a 
separate  copy  of  RMT,  the  system  would  be  cluttered  with  copies  of  RMT 
that  did  not  exit. 


11.2.4  NCR  Control  Commands 

The  MCR  CLI  command  is  the  means  by  which  the  system  has  knowledge  of 
CLIs.  The  CLI  command  has  switches  which  perform  such  functions  as 
making  a  CLI  known  to  the  system,  eliminating  it  from  the  system, 
turning  on  and  off  its  recognition  of  commands,  and  so  forth.  See  the 
RSX-llM/M-PLUS  MCR  Operations  Manual  for  a  description  of  the  CLI 
command. 


11.2.5  System  Messages  to  CLIs 

Depending  on  the  nature  of  the  CLI,  it  may  be  necessary  for  it  to 
receive  r essages  notifying  the  CLI  of  the  occurrence  of  certain  events 
that  could  effect  it.  If  the  /MESSAGE  subkeyword  to  the  CLI  /INIT 
command  is  specified,  it  can  receive  messages  from  the  system 
informing  it  of  such  events.  These  messages  are  returned  by  the  GCCI$ 
directive  just  like  commands.  They  can  be  differentiated  from 
commands  by  the  first  word  of  the  command  buffer  (G.CCDV)  being 
cleared,  instead  of  being  set  up  with  the  name  of  the  device  from 
which  the  command  originated.  The  code  identifying  which  message  is 
present  is  returned  in  the  unit  i\umber  byte  (G.CCUN).  The  other 
fields  have  the  same  meaning  for  messages  as  they  do  for  commands. 
The  actual  text  field  of  the  buffer  may  be  empty  if  the  message  does 
not  contain  any  ASCII  text.  See  the  RSX-llM/M-PLUS  MCR  Operations 
Manual  for  further  information. 

NOTE 

The  CLI  command  includes  both  a  /MESSAGE 
subkeyword  to  the  /INIT  keyword  and  a 
/MESSAGE  keyword.  The  /MESSAGE 
subkeyword  specifies  that  the  CLI  being 
initialized  can  receive  messages.  The 
/MESSAGE  keyword  sends  an  ASCII  message 
to  a  CLI  that  has  been  initialized   with 

the    /MESSAGE    subkeyword.     See   the  

RSX-llM/M-PLUS  MCR  Operations  Manual  for 
further  information. 
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The  following  sections  describe  the  messages.  Message  codes  1  through 
127.  are  reserved  for  use  by  DIGITAL.  Users  wishing  to  create  their 
own  messages  to  CLIs  should  use  codes  in  the  range  of  128.  through 
255.  The  symbol  shown  for  each  message  code  is  defined  in  the 
Executive  definition  library:  LB: [1, 1] EXELIP ,OLB.  Tasks  may  pic< 
them  up  at  build  time  by  linking  with  that  library. 


11.2.5.1  CLI  Initialized  into  an  Enabled  Mode  -  This  message  is  sent 
to  a  CLI  when  it  is  initialized  by  a  CLI  /INIT  command  without 
specifying  the  /DISABLE  switch. 

Message  Code:  1  (CM.INE) 

Text:  CLI  name  in  RAD50,  length  =  4  bytes. 


11.2.5.2  CLI  Initialized  into  a  Disabled  Mode  -  This  message  is  sent 
to  a  CLI  when  it  is  initialized  by  a  CLI  /INIT  command  with  the 
/DISABLE  switch. 

Message  Code:  2  (CM. IND) 

Text;  CLI  name  in  RAD50,  length  =  4  bytes. 


11.2.5.3  CLI  Enabled  -  This  message  is  sent  to  the   CLI   when   it   is 
enabled  by  a  CLI  /ENABLE  command. 

Message  Code:  3  (CM.CEN) 

Text:  None. 


11.2.5.4  CLI  Disabled  -  This  message  is  sent  to  the  CLI   when   it   is 
disabled  by  a  CLI  /DISABLE  command. 

Message  Code:  4  (CM. CDS) 

Text:  None. 


11.2.5.5  CLI  Eliminated  -  This  message  is  sent  to  a  CLI  when   it  has 
been  eliminated  by  an  explicit  CLI  /ELIMINATE  command. 

Message  Code:  5  (CM. ELM) 

Text:  None. 
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11.2.5.6  All  CLIs  Eliminated,  and  must  Exit  -  This  message  is  sent  to 
all  CLIs  on  the  system  which  were  initialized  with  the  /MESSAGE 
subkeyword  to  the  CLI  /INIT  command  when  a  CLI  /ELIM=*  command  is 
issued.  A  CLI  that  receives  this  message  should  exit  as  soon  as 
possible,  since  system  shutdown  or  other  emergency  procedure  is  taking 
place. 

Message  Code:  6  (CM. EXT) 

Text:  None. 


11.2.5.7  Terminal  Linked  to  CLI  -  This  message  is  sent  to  a  CLI  when 

a  terminal  becomes  associated  with  it.   This  message  could  result  from 

a  SET  command  processed   by  MCR,  or   any  other   use  of   the   SCLI$ 
di  rective. 

Message  Code:  7  (CM.LKT) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of   terminal,   length  =   4 
bytes.   (2  bytes  each). 


11.2.6.8   Terminal  Removed  from  CLI  -  This  message   is  sent   to 
terminal's  former  CLI  when  it  is  switched  to  another  CLI. 

Message  Code:  8.   (CM.RMT) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of   terminal,   length   = 
bytes.   (2  bytes  each) . 


11.2.5.9  General  Message  -  This  message  is  the  result  of  a  the  CLI 
/MESSAGE  command.  It  contains  whatever  text  the  issuer  of  the  command 
included  in  the  string,  plus  the  name  and  unit  number  o£  the  terminal 
on  which  the  command  was  typed. 

Message  Code:  9.   (CM.MSG) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of  terminal  where  the  CLI 
/MESSAGE  command  originated,  followed  by  the  tex*-  from  the 
command  string.  The  length  is  equal  to  the  length  of  .le  string 
(possibly  zero)  plus  the  length  of  the  terminal  name  and  unit 
number  (2  bytes  each) . 


11.2.6   Prompting 

There  are  three  kinds  of  prompts  issued   by   the   system   that   affect 
CLIs: 

1.  CTRL/C  prompts 

2.  Empty  line  prompts  generated  by  solitary  carriage  returns 

3.  Task  exit  prompts 
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11.2.6.1  CTRL/C  Prompts  -  This  prompt  is  issued  by  the  terminal 
drivci  when  it  receives  a  CTRL/C  character.  The  string  to  be  issued 
can  be  specified  when  the  CLI  is  initialized.  There  is  no  way  the  CLI 
can  be  notified  when  this  prompt  is  issued,  however,  since  it  is 
handled  by  the  terminal  driver.  These  prompts  are  of  no  other  concern 
to  CLIs. 


11.2.6.2  Empty-Line  Prompts  -  This  prompt  results  from  terminal  input 
consisting  solely  of  a  carriage-return  character,  which  is  called  a 
iiull  command  line.  The  standard  system  action  is  to  have  the  MCR. . . 
task  issue  the  default  prompt,  which  can  be  specified  when  the  CLI  is 
initialized.  Tht  CLI  can  be  initialized  with  the  /NULL  switch,  which 
causes  the  system  to  send  null  command  lines  to  the  CLI  like  other 
commands,  and  not  output  anything.  Any  prompting  or  other  action  Is 
therefore  the  CLI's  responsibility. 


11.2.6.3  Task-Exit  Prompts  -  These  prompts  are  issued  when  a  task 
started  by  a  command  line  exits.  The  standard  system  action  is  to 
have  the  MCR...  task  issue  the  same  default  prompt  string  as  in  the 
case  of  an  empty  line.  If  the  CLI  wishes  to  be  informed  of  these 
occurrences,  it  can  be  initialized  with  the  /PROMPT  switch,  which 
causes  the  system  to  send  these  task  exit  prompt  requests  to  tne  CLI 
without  terminal  output.  Any  prompting  or  other  action  is  then  the 
CLI's  rasponsibility. 

On  RSX-llM-PLUS  systems,  a  CLI  initialized  to  receive  either 
empty-line  or  task-exit  prompts  has  to  issue  an  SNXC$  directive  when 
its  processing  of  the  prompt  is  complete.  SNXC$  tells  the  terminal 
d.'iver  that  the  current  command  is  complete.,  and  it  can  send  the  next 
one  if  the  terminal  is  in  serial  processing  mode.  This  directive  can 
be  issued  if  the  terminal  is  not  in  serial  mode  without  any  adverse 
effects.  See  Section  11. 2. S,  Serial  Command  Processing,  for  further 
details. 


11.2.7   System  Handling  of  Continuation  Lines 

Continuation  lines  are  handled  by  the  RSX-llM-PLUS  terminal  driver 
before  the  command  is  passed  to  the  CLI.  Incomplete  segments  of 
command  lines  are  detected  by  the  presence  of  a  hyphen  as  the 
character  immediately  preceding  the  terminator.  Any  hyphens  are 
removed  and  all  the  pieces  of  the  command  put  together  before  the  CLI 
is  aware  of  the  command,  so  the  CLI  does  not  have  to  deal  with 
continuation  lines  in  any  way.  If  the  CLI  does  not  want  the  system  to 
interpret  the  presence  of  the  hyphen  as  denoting  a  continuation  line, 
it  can  be  initialized  with  the  /SNGL  switch.  This  tells  the  system  to 
accept  single  line  commands  only,  and  pass  every  line  to  the  CLI  as  it 
is  entered.   No  continuation  line  checks  are  made. 

The  DCL  CLI  on  RSX-llM  does  its  own  handling  of  continuation  lines. 
This  is  done  within  DCL  itself,  and  is  not  available  as  a  general 
system  feature.  This  option  is  open  to  CLIs  on  RSX-llM  systems,  but 
is  not  necessary  for  CLIs  on  RSX-llM-PLUS  as  the  system  puts  all  the 
segments  together  before  the  command  is  sent  to  the  CLI. 
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11.2.8   Interaction  with  Serial  Command  Processing  (R8X-11M-PLUS  only) 

Serial  command  processinq  is  a  mode  in  which  commands  from  a  terminal 
are  executed  in  sequential  order,  with  a  command  not  being  started 
until  the  preceding  command  is  finished.  The  default  for  command  line 
processing  on  RSX-llM-PLUS  systems  is  parallel  processing,  but  a  CLI 
may  need  to  synchronize  commands.  Command  synchronization  is  achieved 
by  having  the  terminal  driver  store  characters  in  the  typeahead  buffer 
if  they  are  entered  while  a  command  is  outstanding  on  that  terminal. 
These  characters  are  issued  as  the  next  command  by  a  special  call  to 
the  terminal  driver  at  the  completion  of  the  processing  of  the  current 
command.  This  command  completion  is  normally  signalled  to  the  system 
by  the  exiting  of  the  final  task  involved  in  the  processing  of  the 
command. 

If  a  task  -  either  the  CLI  or  a  task  chained  to  by  RPOI$  or  3DRP$  - 
exits  at  the  completion  of  command  execution  and  no  prompt  request  is 
generated  (meaning  the  command  was  terminated  by  an  ESCAPE  character) , 
the  terminal  driver  is  called  directly  from  the  task  exit  code  in  the 
Executive.  If  a  task  exit  ^'ompt  request  is  generated,  the  terminal 
driver  has  to  be  called  at  the  completion  of  the  prompt  re';iuest 
processing.  If  the  CLI  is  not  receiving  prompt  requests,  the  terminal 
driver  call  is  done  automatically  by  the  system,  and  the  CLI  need 
never  get  involved. 

If  the  CLI  has  been  initialized  to  receive  prompt  requests,  the  system 
passes  the  prompt  request  on  to  the  CLI  like  any  other  command.  It 
becomes  the  CLI's  responsibility  to  write  any  prompt  string  to  the 
terminal  and  call  the  terminal  driver  to  initiate  the  next  command. 
The  CLI  should  therefore  issuo  an  SNXC$  directive  at  the  completion  of 
its  processing  of  the  prompt  request. 

If  no  task  exit  will  occur  to  terminate  the  command  execution,  the 
system  has  no  way  of  knowing  when  the  command  is  complete.  Therefore 
the  SNXC$  directive  must  be  used  to  mark  the  end  of  the  comr.and  and 
cause  the  next  one  to  be  initiated.  Issuing  this  directive  causes  a 
task  exit  prompt  request  to  be  generated  if  one  would  h .ve  been 
generated  by  a  task  exit.  If  no  prompt  request  is  generated,  SNXC$ 
calls  the  terminal  driver  to  send  the  next  command  to  the  system  for 
processing.  This  directive  can  be  issued  by  the  CLI  or  the  final  task 
chained  to  by  means  of  an  RPOI$  or  SDRP$  directive. 

It  is  not  necessary  for  applications  using  the  SNXC$  directive  to 
check  if  a  terminal  is  actually  in  serial  mode.  If  th<!  terminal  is 
not  in  serial  mode,  the  terminal  driver  sends  commands  to  the  system 
as  they  are  entered.  The  directive  does  not  cause  the  terminal  driver 
to  be  called  since  it  is  not  necessary.  The  terminal  driver  still 
generates  a  task  exit  prompt  request  if  one  would  have  been  generated 
when  the  task  exited.  The  issuance  of  this  directive  clears  the 
status  bits  that  tell  the  system  to  generate  a  prompt  request  or  call 
the  terminal  driver  at  task  exit.  Therefore  a  task  exiting  after 
ifsuing  an  SNXC$  directive  does  not  cause  two  prompt  requests  to  be 
is.  ued. 

See  the  RSX-llM/M-PLUS  Executive  Reference  Manual  for  more  inforii.ation 
on  the  SNXC$  directive. 
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11.3   SIMPLE  SAMPLE  CLI 

Here  is  a  sample  CLI,  written  in  both  MACRO-11  and  FORTRAN.  The  same 
programs  are  included  on  your  system  kit  as  TMCLI.MAC  or  TMCLI.F'^N. 
This  CLI  is  as  simple  as  possible  to  illustrate  what  is  necessary  to 
construct  a  CLI.  All  TMCLI  does  is  receive  commands  and  pass  them  to 
MCR  for  execution.  A  user  of  this  CLI  may  not  even  be  aware  that  it 
is  there  as  there  is  no  apparent  difference  from  being  an  MCR 
terminal.  The  only  additional  capabilities  TMCLI  offers  are  two 
single-letter  commands,  T  to  type  a  file,  or  M  to  switch  back  to  MC« 
mode.  The  comments  in  the  listing  suggest  several  simple 
modifications  that  can  be  made  to  illustrate  the  options  available 
when  designing  or  setting  up  a  CLI. 


11.3.1   MACRO-11  CLI 

.TITLE  TMCLI  -  EXAMPLE  CLI  THAT  IMPLEMENTS  'T*  AN[i  'M'  COMMANt" 
lOENT   /I. 00/ 
t 

»  THIS  TASK  (TMCLI)  U LUSTRATES  THE  USE  OF  THE  CLI  CONTROL  DIRECTIVES  OF 

»  RSX-llM  W4.0  AND  RSX-llN-PLUS  V2.0. 
I 

»  MHEN  SET  UP  AS  A  TERMINALS  CLI.  IT  PROVIDES  THE  FOLLOWING  COMMANDS: 
I 

•  T        ->       TYPE  FILE 

I         N        ->       SET  TERMINAL  TO  MCK 

I 

»  IF  THE  FIRST  TWO  LETTERS  OF  THE  COMMAND  ARE  NOT  'T*  FOLLOWED 

»  BY  A  SPACE.  OR  'M*  FOLLOWED  BY  A  CARRIAGE  RETURN. 

»  THE  COMMAND  IS  PASSED  TO  MCR  FOR  EXECUTION.  THEREFORE. 

I  USERS  AT  TERMINALS  SET  TO  THIS  CLI  WILL  SEE  THE  ENTIRE  MCR  COMMAND  SET 

♦  AS  BEING  PRESENT.  PLUS  THE  'T*  AND  'M*  COMMANDS.  IF  THE  /DPR  SUBKEYWORD 
»  IS  INCLUDED  ON  THE  CLI  /INIT  COMMAND.  USERS  WILL  KNOW  IMMEDIATELY  IF 

»  THEIR  TE;J1INAL  IS  SET  TO  THIS  CLI  BY  THE  DOUBLE  RIGHT  ANGLE  BRACKET  PROKPT. 

i 

i  IF  TMCLI  IS  INITIALIZED  WITH  THE  /MESSAGE  KEYWORD.  TMCLI  WILL 

I  GREET  USERS  WHEN  THEIR  TERMINAL  IS  SET  TO  THE  CLI.  AND  SAY  GOODBYE 

»  TO  THEM  WHEN  THEY  SWITCH  AWAY. 

I 

»  IN  L  OER  TO  BRING  THIS  CLI  UP  ON  THE  SYSTEM.  ISSUE  THE  FOLl  OWING 

t  COMMAND  sequence: 

» 

I  >MAC    TMCLI. TMCLI/-SP=TMCLI 

»  >TKB    TMCLI. TCCLI/'SPsTMCLI. CI. 13EXELIB/LB 

I  >IMS    TMCLI/CLI«YES/TASK=. . .TMC 

»  >CH    /INIT»TMCLI/MESSAGE/DPR='<15><12>/    >/VTASR=.  .  .TMC 

t 

t         TO  SET  TERMINALS  TO  THIS  CLI.  ISSUE  THE  FOLLOWING  COMMAND 

I         WHERE  TTNN:  is  REPLACED  BY  THE  TERMINAL  NUMBER  OR  Ti: 

I 

»  >8ET  /CLI-TTNN5TMCLI 

i 

»  MOTE  THAT  THE  PROMPT  ISSUED  IN  RESPONSE  TO  A  CONTROL/C  DEFAULTS  TO  THE 

»  NAME  OF  THE  CLI.  WHICH  IS  'TMCLIJ*. 

> 

>  THCLI  CAN  BE  ELIMINATED  FROM  THE  SYSTEM  BY  THE  FOLLOWING  COMMANDS.  ASSUMING 

t  NO  TERMINALS  ARE  SET  TO  IT: 

I 

I  >CLI    /ELIM-TMCLI 

I  >REH    . . . TMC 

I 
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»  EXPERIMENT  MITH  THE  OTHER  SUBKEYUORDS  OF  THE  CLI  /INIT  COMMANIir  THE  CLI 

i  /ENABLE  AND  CLI  /DISABLE  COHMANDSt  AND  WITH  THE  /MESSAGE  SWITCH  ON  THE  /INIT 

»  COMMAND  TO  OBSERVE  THE  EFFECTS.   ALSO  TRY  CHANGING  THE  /TASK= 

I  SWITCH  ON  THE  INS  AND  CLI  /INIT  COMMAND  TO  • /TASK^TMCL! •  AND  NOTICE 

I  THAT  ONLY  ONE  COPY  OF  THE  TASK  WILL  EXIST  KOR  ALL  TERMINALS.  RATHER  THAN 

»  ONE  PER  COMMAND.  IF  YOU  DO  THIS.  YOU  SHOULD  ALSO  CHANGE  THE  OPTION 

I  ON  THE  OCCI»  DIRECTIVE  FROM  GC.CEX  TO  OC.CST  SO  THE  TASK  WILL  STAY  ACTIVE 

i  BUT  STOPPED  WHEN  NO  COMMANDS  ARE  OUTSTANDING  FOR  IT. 

t 

.MCALL   GCCI*.RF'OI«.EXIT«S.QIOW«tALUN*ftiIR« 
t 

i  DIRECTIVE  DPBS 
t 

GCCi:    GCCI*    CMDBUF.CDLEN.IBUF.IBLEN.O. GC.CEX 
RPOi:    RPOI«    MCR... 
QIOW:    QIOW*    lO.WVB.Stl^ f . .< > t40> 

alun:   alun*   s 


I 

t    BUFFER  AREAS 
) 

cmdbuf:  .blkb 


B0.+6.CCBF       ILENQTH  »  HEADER  PLUS  COMMAND  IN  BYTES 

JNOTE  THAT  ON  M-PLUS  i HE  MAXIMUM  COMMAND 
>LEN6TH  IS  255.  BYTES.  SO  THE  LENGTH  SHOULD 
•BE  <255.+G.CCBF>  OR  CHARACTERS  MAY  BE  LOST. 


CBLEN>. -CMDBUF 
.EVEN 


(CALCULATE  LENGTH 


IBUF:    .BLKB    6.CCCA'f2 
IBLEN-.-IBUF 
.EVEN 


tLONG  ENOUGH  TO  CONTAIN  ALL  INFORMATION 
(CALCULATE  LENGTH 


tcmd:   .ASCII  /PIP  Ti:=/ 

TCLEN«.-TCMD 

BUF:     .BLKB    80.-TCLEN 
.EVEN 


(BASIC  PIP  COMMAND  TO  IMPLEMENT  'T*  COMMAND 

(LENGTH  OF  COMMAND 

(BUFFER  TO  GENERATE  COMMANDS  IN 


MCR: 


.ASCII   /M/<15> 


(STRING  TO  RECOGNIZE  AS  A  SET  TO  MCR  REQUEST 


MCMD:    .ASCII   XSET  /MCR=Ti:X   (SET  TERMINAL  TO  MCR  COMMAND 
HCLEN-.-MCMD  (LENGTH  OF  COMMAND 

.EVEN 


(  TEXT  TO  BE  DISPLAYED  UPON  RECEIPT  OF  NEW  TERMINAL-LINKED  OR 
(  TERMINAL-REMOVED  MESSAGES  FROM  SYSTEM. 

^ 

LKT:     .ASCII   <15><12>/WELC0ME  TO  THE  EXAMPLE  CLI/<15><12> 
LKTLEN-.-LKT 
.EVEN 

RMTS     .ASCII   <15><12>/G00D  BYE  FROM  THE  EXAMPLE  CLI/<i5><12> 
RMTLEN-.-RMT 
.EVEN 

I 

(  MESSA8E  FOR  CHARACTERS  LOST  DUE  TO  BUFFER  BEING  TOO  SHALL 

( 

CHLOST:  .ASCII   <15><12:>/S0RRY.  PART  OF  YOUR  COMMAND  WAS  L0ST/<15><12> 

CLLEN=.-CHLOST 
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I 

I  ILLEGAL  COHMAND  HESSAOE 
» 

ill:     .ASCII   <15><12>/ILLEGAL  C0HMAND/<15><12> 
ILLLEN-.-ILL 
.EVEN 

t 


(  CLI  CODE 
I 


start: 


.ENABL 

PIR« 

DCS 


LSB 
•  GCCI 

loot 


»6ET  A  COHHAND  FROH  SYSTEH 
»IF  CS»  DIRECTIVE  ERROR 


t    IF  THE  OCCI«  DIRECTIVE  HAD  THE  OC.CST  OPTION  SPECIFIED. 
}  JUST  BEEN  UNSTOPPED.  SO  WE  HAVE  TO  GET  THE  CONHAND . 


UE  MAY  HAVE 


CMP 

•IS.CLR.tPSW 

Bca 

START 

NOV 

•CHDBUF.RO 

TiT 

(RO) 

BEB 

HSG 

CMPB 

G.CCCT(RO).G 

BLO 

1S0« 

HOV 

•RPOIfRS 

(WERE  UE  JUST  UNSTOPPED? 

>IF  EQ  YES 

SPOINT  TO  COHHAND  BUFFER 

MS  THIS  A  SYSTEM  MESSAGE'? 

»IF  EO  YES 
CL(RO>  8DID  ENTIRE  COMMAND  FIT  IN  BUFFER 

ilF  LO  NO 

IPOINT  TO  DPB  OF  RPOI«  DIRECTIVE 
t 
i    AT  THIS  POINT.  THE  CLI  HAS  A  COMMAND  TO  BE  PROCESSED.  THE  CODE  FROM 

*  THE  'START:*  LABEL  TO  HERE  SHOULD  BE  FAIRLY  COMMON  AMONG  ALL  CLIS. 

I  FROM  THIS  POINT  ON.  THE  CODE  WILL  BE  SPECIFIC  TO  THE  PARTICULAR  LANGUAGE 

I    THIS  CLI  IS  IMPLEMENTING.  COMMANDS  CAN  BE  ADDED  OR  DELETED  AT  WILL 

t    BY  MODIFYING  CODE  IN  THIS  SECTION.  AS  STATED  ABOVE.  THIS  EXTREMELY 

t  SIMPLE  CLI  PROVIDES  TWO  COMMANDS.  AND  GIVES  EVERYTHING  ELSE  TO  MCR. 

)  THIS  CREATES  AN  OPEN  ENDED  ENVIRONMENT.  REJECTING  UNRECOGNIZED  COMMANDS 

I  INSTEAD  OF  PASSING  THEM  TO  MCR  WOULD  LIMIT  THE  TERMINAL  USER'S  USE  OF 

{  THE  SYSTEM  TO  ONLY  THOSE  OPERATIONS  ALLOWED  BY  THE  CLI.  THIS  IS 

i  A  SECURE  WAY  OF  CONTROLLING  SYSTEM  USE.  IN  CASES  WHEN  IT  IS  NECESSARY. 

t  IN  THIS  EXAMPLE.  CHANGING  THE  * BNE  SO*'  BELOW.  TO  A  ' BNE  60« * 

I  WOULD  CREATE  AN  ENVIRONMENT  WHERE  THE  ONLY  OPERATION  A  USER  COULD 

(  PERFORM  WOULD  BE  TO  TYPE  FILES  ON  THE  TERMINAL.  OR  SWITCH  BACK  TO  MCR. 

*  ALL  OF  THE  REST  OF  THE  SYSTEM  IS  INACCESSIBLE.  IF  NO  MEANS  OF  SWITCHING 
I  BACK  TO  MCR  IS  PROVIDED.  IT  IS  IMPOSSIBLE  FOR  THE  USER  TO  DO 

t    ANYTHING  THE  CLI  DOES  NOT  EXPLICITLY  LET  HIM  DO. 
» 

CUP      t'T  .G.CCBF(RO>  (IS  IT  A  'T'  COMMAND? 

ICQ      10«  HF  EQ  YES 

CMP      HCRtG.CCBF(RO)   »IS  IT  AN  'M'  COMMAND? 


t 

»  CHANGE  THE  NEXT  INSTRUCTION  TO  'BNE  &0f  TO  ELIMINATE  PASSING  UNKNOWN 

I  COMMANDS  TO  MCR. 

I 

BNE      SO*  II F  NE  NO 


11-12 


COMMAND  LINE  INTERPRETERS 


t  THE  USER  HAS  ENTERED  AN  'h'  COHHAND*  SO  SET  THE  TERMINAL  TO  HCR . 

i 

HOV      •HCHD>R.r'OBF(RS>   iPUT  ADDRESS  OF  CMD  TO  ISSUE  IN  DF-V 
NOV      ♦MCLENrR.P0£lL(R5>  »PUT  LENOTH  OF  CMD  IN  DPb 
IR       ISSChD  » ISSUE  COHHAND 

t 

»  THE  USER  HAS  ENTERED  A  'T'  COMMAND  SO  CONSTRUCT  THE  NECESSARY  FIF' 
f    COMMAND  AND  SEND  IT  TO  MCR. 


io«: 


>0»i 


30«i 


JCOPY  ADDRESS  OF  BUFFER  WITH  COMMAND 
»FOINT  TO  SPACt  AFTER  THE  T 
IPOINT  TO  BUFFER  THAT  WILl.  CONTAIN  CMD 
»OET  LENGTH  OF  INITIAL  PART  OF  COMMAND 
(GET  NEXT  CHARACTER 
>IS  IT  THE  END  OF  THE  COMMAND 
I  IF  EQ  YES 
»IS  IT  A  SPACE 
»IF  EQ  YES.  SKIP  IT 
JPUT  CHARACTER  IN  OUTPUT  BUFFER 
•COUNT  CHARACTER 
»GET  NEXT  CHARACTER 
•  TCMD.R.P0tiF(R5>»PUT  ADDRESS  OF  CMD  TO  ISSUE  IN  DPB 
J  INSERT  LENGTH  OF  COMMAND 


HOV 

R0»R1 

ADD 

•G.CCBF^l.Rl 

NOV 

•BUF.R2 

NOV 

•TCLEN.R4 

HOVB 

(Rl )i.R3 

CMPB 

•1S>R3 

BEQ 

30* 

CMPB 

•40rR3 

BEO 

20» 

HOVB 

R3.<R2)t 

INC 

R4 

IR 

20» 

HOV 

•TCMD.R.POBF 

MOV 

R4rR.P0BL<R5 

THIS  COMMAND  WILL  BE  PASSED  TO  THE  MAIN  COMMAND  DISPATCHER  (MCR...)> 
WHICH  WILL  START  A  COPY  OF  PIP  AND  GIVE  IT  THE  COMMAND.  THE  RPOI 
DIRECTIVE  COULD  BE  USED  TO  GIVE  THE  COMMAND  DIRECTLY  TO  ...PIP  AND 
GIVE  THE  RESULTING  TASK  A  DIFFERENT  NAME.  IN  THIS  EXAMPLE. 
HE  COULD  CALL  THE  RESULTING  PIP  TASK  'TYPTNN*  WHERE  THE  LAST 
THREE  CHARACTERS  (TNN)  ARE  REPLACED  BY  A  DEVICE  NAME  CHARACTER  AND 
UNIT  NUMBER.  FOR  EXAMPLE.  IF  THE  'T*  COMMAND  WAS  TYPED  ON  TTIO: 
THE  RESULTING  TASK  NAME  COULD  BE  MADE  TO  BE  'TYPTIO'.  THIS  HAS  THE 
ADVANTAGE  OF  ALLOWING  THE  TASK  TO  BE  ABORTED  BY  AN  'ABO  TYP'  COMMAND. 
INSTEAD  OF  'ABO  PIP'.  THUS  THE  USER  WOULD  NOT  HAVE  TO  KNOW  THAT  THE 
•T*  COMMAND  HE  ISSUED  IS  ACTUALLY  BEING  SERVICED  BY  THE  PIP  TASK.  THIS 
IS  EXACTLY  WHAT  THE  DCL  CLI  DOES.  IT  IS  NOT  DONE  HERE 
TO  SIMPLIFY  THE  EXAMPLE.  PICKING  UP  THE  TERMINAL  NAME  AND  UNIT 
NUMBER.  CONVERTING  IT  TO  RADSO.  AND  SUPPLYING  IT  IN  THE  RPOI  DIRECTIVE 
ALONG  WITH  A  DIRECT  REQUEST  OF  PIP  IS  LEFT  AS  AN  EXERCISE  TO  THE  USER. 
<BE  CAREFUL  ON  RSX-llM-PLUS  SYSTEMS  WITH  MORE  THAN  44.  TERMINALS). 
NOTE  THAT  REQUESTING  PIP  DIRECTLY  AVOIDS  A  SUBSTANTIAL  AMOUNT  OF  SYSTEM 
OVERHEAD. 


BR 


ISSCMD 


lEXECUTE  COMMAND 


COMMAND  IS  NOT  'T*  OR  'M*.  SO  GIVE  IT  TO  MCR  AS  IS. 


so<: 


MOV 
MOVB 


•CMDBUF4G.CCBF.R.P0BF<R5)  ;PUT  ADDRESS  OF  STRING  IN  DPB 
G.CCCT<R0).R.P0BL<R5)  >PUT  LENGTH  IN  RPOI  DPB 


I 

(  ISSUE  RPOI*  DIRECTIVE  TO  EXECUTE  CO.MMAND 
> 

(RO) .R.PODV<RS)  ;PUT  NAME  OF  ISSUING  DEVICE  IN  RPOI 

G.CCUN(RO) .R.POUN(RS>  ;COPY  UNIT  NUMBER 

IBUF+G.CCPU.R.P0UM<R5)   »PROPAGATE  UIC  OF  TERMINAL 

IBUF+G.CCPU+1 .R.P0UG(R5> 

IBUFiG.CCOA.R.POOACRS)   ;COPY  ID  PARENT  IN  CASE  WE  WERE  SPAWNED 

•RPOI  $PASS  COMMAND  TO  EXECUTOR  TASK 

START  JIF  CC.  SUCCESS 

not  lERROR 


ISSCHD:  MOV 
MOVB 
MOVB 
MOVB 
MOV 
DIR9 

tec 

BR 
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I 

I  CONTROL  IS  TRANSFERRED  HERE  IF  UNKNOWN  CONHANDS  ARE  TO  BE  REJECTED 

>  INSTEAD  OF  BEING  PASSED  TO  NCR. 

I 

•POINT  TO  MESSAGE  TO  BE  PRINTED 

(GET  LENGTH  OF  MESSAGE 

i ISSUE  MESSAGE 

»TRY  FOR  NEXT  COMMAND 


•FATAL  ERROR  ON  GCCIt 

•FATAL  ERROR  ON  RPOIt 
•FATAL 

•POINT  TO  MESSAGE  TO  BE  PRINTED 
•GET  LENGTH  OF  MESSAGE 
•ISSUE  MESSAGE 


60»: 

MOV 

•ILL.Rl 

MOV 

«ILLLEN>R2 

CALL 

ISSMSG 

BR 

START 

• 

•  ERROR 
1 

HANDLING  CODE 

ioo«: 

CLR 

->o 

BR 

,.50» 

no«! 

MOV 

•  1>R0 

i20»: 

lOT 

iso«: 

MOV 

♦CHLOST.Rl 

MOV 

•CLLEN,R3 

CALL 

ISSMSG 

BR 

START 

.DSABL 

LSB 

t    A  SYSTEM  MESSAGE  WAS  RECEIVED  INSTEAD  OF  A  COMMAND. 
t 


msg: 


CMPB 

BEQ 

CMPB 

BEQ 

CMPB 

BEQ 

CMPB 

BEQ 

BR 


•CM.LKTf6.CCUN(R0)  JIS  IT  A  NEU  TERMINAL  LINKED  TO  US? 

10»  •IF  EQ  YES 

♦CM.RMT.G.CCUN<RO)  JIS  IT  A  TERMINAL  BEING  REMOVED 

20»  »IF  EQ  YES 

•CM.EXT>G.CCUN(RO)  •IS  IT  AN  ELIMINATE  ALL  PACKET 

SO*  •IF  EQ  YES 

•CM.ELMtG.CCUN<RO>  •IS  IT  A  CLI  ELIMINATION  MESSAGE 


50« 
START 


t 

•  ISSUE  WELCOME  MESSAGE 

• 

lot:     MOV  tLKTrRl 

MOV  tLKILENfR? 

ADD  tCCCBFrRO 

BR  30* 


•IF  EG  YES 

•IGNORE  ALL  OTHER  MESSAGES 


•POINT  TO  MESSAGE  TEXT 

•GET  LENGTH 

•POINT  TO  TERMINAL  THAT  WAS  SET 

» 


t  ISSUE  GOODBYE  MESSAGE 

• 

20t:     MOV      tRMTiRl 

MOV      «RMTLEN>R2 

ADD      tG.CCBF.RO 
30«t     CALL     ISSMSG 

JMP      START 
t 
•  WHEN  AN  ELIMINATE  ALL  MESSAGE  IS  RECEIVED*  EXIT  IMMEDIATELY. 

so»:    exiT»s 


•POINT  TO  MESSAGE  TEXT 

•GET  LENGTH 

•POINT  TO  TERMINAL  NAME 

•ISSUE  MESSAGE 

•GET  NEXT  COMMAND 
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»    ROUTINE    TO    PRINT    TO    TERMINAL 
i 

i 

i   inputs: 
I 

»         RO=ADDRESS  OF  NAME  OF  TERMINAL  TO  PRINT  TO 

I        R1>ADDRESS  OF  MESSAGE  TO  PRINT 

t        R2>=LENGTH  OF  MESSAGE 

r 

»  OUTPUTS! 

» 

I         NONE 

» 

J  THIS  ROUTINE  PRINTS  THE  SPECIFIED  MESSAGE  UN  THE  SPECIFIEU  TERMINAL. 

»  ALL  ERRORS  THAT  MIGHT  RESULT  ARE  IGNORED.  IN  GENERALr  CLIS  SHOULD 

»  DO  ASYNCHRONOUS  I/O  WITH  COMPLETION  ASTS.  AND  PROVIDE  A  TIME-OUT 

»  FACILITY  TO  KILL  THE  I/O  IF  IT  HASN'T  COMPLETED  IN  A  CERTAIN 

i  AMOUNT  OF  TIME.  THIS  PREVENTS  TERMINAL  1/0  FROM  HOLDING  UP 

I  COMMAND  PROCESSING.  THIS  IS  NOT  DONE  HERE  FOR  SIMPLICITY. 

t 

ISSMSG:  MOV  (RO) fALUN+A.LUNA   «SET  up  device  NAME 

MOVB  2(R0>'ALUNf A.LUNU  rAND  UNIT  NUMBER 

CLRB  ALUN+A.LUNU+1    JCLEAR  HIGH  BYTE 

DIR*  *ALUN  >ASSIGN  LUN  S  TO  THE  SPECIFIED  DEVICE 

BCS  10»  »IF  CSi  SKIP  I/O 

MOV  Rl fOIOUfO. lOPL   fSET  ADDRESS  OF  MESSAGL 

MOV  R2.QI0UtQ.I0PL+2  JINSERT  LENGTH  OF  MESSAGE 

DIR«  tQIOU  >D0  I/O  AND  WAIT  FOR  ir 

10«:     RETURN 

.ENil     START 


11.3.2   FORTRAN  CLI 

C 

C  THIS  TASK  (TMCLI)  ILLUSTRATES  THE  USE  OF  THE  CLI  CONTROL  DIRECTIVES  OF 

C  RSX-llH  V4.0  AND  RSX-llM-PLUS  V2.0. 

C 

C  UHEN  SET  UP  AS  A  TERMINAL'S  CLIt  IT  PROVIDES  THE  FOLLOWING  COMMANDS'. 

C 

C        T        ->       TYPE  FILE 

C        H        ->       SET  TERMINAL  TO  MCR 

C 

C  IF  THE  FIRST  TWO  LETTERS  OF  THE  COMMAND  ARE  NOT  'T*  FOLLOWED 

C  BY  A  SPACE*  OR  'M'  FOLLOWED  BY  A  CARRIAGE  RETURNi 

C  THE  COMMAND  IS  PASSED  TO  MCR  FOR  EXECUTION.  THEREFOREt 

C  USERS  AT  TERMINALS  SET  TO  THIS  CLI  WILL  SEE  THE  ENTIRE  MCR  COMMAND  SET 

C  AS  BEING  PRESENT.  PLUS  THE  'T'  AND  'M'  COMMANDS.  IF  THE  /DPR  SUBKEYWORD 

C  IS  INCLUDED  ON  THE  CLI  /INIT  COMMAND.  USERS  WILL  KNOW  IMMEDIATELY  IF 

C  THEIR  TERMINAL  IS  SET  TO  THIS  CLI  BY  THE  DOUBLE  RIGHT  ANGLE  BRACKET  PROMPT, 

C 
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C  IF  THCLI  IS  INITIALIZED  yiTH  THE  /MESSAGE  KEYWORD.  TMCLI  MILL 

C  GREET  USEfVS  UKEN  THEIR  TERMINAL  IS  SET  TO  THE  CL I  >  AND  SAY  GOODBYE 

C  TO  THEN  WHEN  THEY  SWITCH  AWAY. 

C 

C  IN  ORDER  TO  BRING  THIS  CLI  UP  ON  THE  SYSTEM.  ISSUE  THE  FOLLOWING 

C  COMMAND  sequence: 

C 

C    >FOR    TMCLI. TMCLI/-SP=TMCLI 

C    >TKB    TMCLI/FPfTMCLI/-SP  =  TMCLI.Cl.nFOROTS/LB 

C    >INS    TMCLI/CLI«=YES/TASK=.  .  .TMC 

C    >CLI    /INIT  =  TMCLI/HESSAGE/DPR  =  '  ;i5><12:>/>>/VTASK=.  .  .TMC 

c 

C  IF  USING  FORTRAN  IV-PLUS  INSTEAD  OF  FORTRAN  IV.  THE  FIRST  TWO 

C  COMMANDS  ABOVE  WOULD  BE: 

C 

C  >F4P    TMCLI. TMCLI/-SP=TMCLI.FTN 

C  >TKB    TMCLI/FP.TMCLI/-SP  =  TMCI   '  .Cl.nF4P0TS/Lb 

C 

C  TO  SET  TERMINALS  TO  THIS  CL . .  ISSUE  THE  FOLLOWING  COMMAND 

C  WHERE  TTNN:  IS  REr^LACED  BY  THE  TERMINAL  NUMBcR  OR  Ti: 

C 

c  >SET  /cli=ttnn:tmcli 

C 

C  NOTE  THAT  THE  PROMPT  ISSUED  IN  RESPONSE  TO  A  CONTROL/C  DEFAULTS  TO  THE 

C  NAME  OF  THE  CLI.  WHICH  IS  'TMCLI>*. 

C 

C  TMCLI  CAN  BE  ELIMINATED  FROM  THE  SYSTEM  BY  THE  FOLLOWING  COMMANDS.  ASSUMING 

C  NO  TERMINALS  ARE  SET  TO  IT: 

C 

C  >CLI  /ELIM=TMCLI 

C  >REM  .  .  .TMC 

C 

C  EXPERIMENT  WITH  THE  OTHER  SUBKEYWORDS  OF  THE  CLI  /INIT  COMMAND.  THE  CLI 

C  /ENABLE  AND  CLI  /DISABLE  COMMANDS.  AND  WITH  THE  /MESSAGE  SWITCH  ON  THE  /INIT 

C  COHMAND  TO  OBSERVE  THE  EFFECTS.  ALSO  TRY  CHANGING  THE  /TASK= 

C  SWIfCH  ON  THE  ..NS  AND  CLI  /INIT  COMMAND  TO  VTASIOTMCLI '  AND  NOTICE 

C  THAT  ONLY  ONE  COPY  OF  THE  TASK  WILL  EXIST  FOR  ALL  TERMINALS.  RATHER  THAN 

C  ONE  PER  COMMAND.  IT  YOU  DO  THIS.  YOU  SHOULD  ALSO  CHANGE  THE  OPTION 

C  ON  THE  GTCMCI  DIRECTIVE  FROM  GC.CEX  TO  GC.CST  SO  THE  TASK  WILl  STAY  ACTIVE 

C  BUT  STOPPED  WHEN  NO  COMMANDS  ARE  OUTSTANDING  FOR  IT. 

C 

c 

C  BUFFER  AREAS 

C 

C     COMMAND  BUFFER  -  THIS  BUFFER  IS  USED  IN  THE  GTCMCI  DIRECTIVE.   IT  CON- 

C  TAINS  INFORMATION  ON  THE  COMMAND  RECEIVED  <8  BYTES) 

C  AND  THE  COHMAND  TEXT. 

BYTE  CH0BUF(264> 

INTEGER«2  CBLEN  !  NOTE  THAT  ON  M+  THt  MAXIMUM  COMMAND 

DATA  CBLEN/2A3/  !  LENGTH  IS  255. 

INTEGER»2  GCCDV.  GCCCL   !  ASCII  DEV  NAM.  »  CHARS  IN  CMD  LINE 

BYTE  GCCCT.  GCCUN.  GCCBF(255)  !  ♦  OF  CHARS.  TERMINAL  UNIT  ♦.  CMD 

EQUIVALENCE  (GCCDV. CMDBUF ) .  (GCCCL .CMDBUF ( S) ) >  (GCCCT .CMDBUF ( 4 ) ) . 

1  (GCCBF.CMDBUF(9>).  (GCCUN. CMDBUF (3 > > 
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C     INFORHATION  BUFFER  -  ALSO  RETURNED  IN  THE  GTCHCI  DIRECTIVE. 
C 

BYTE  IBUF(14) 

INTE0ER«2  OCCF-U 

DATA  IBLEN/14/.GCCPU/9/  i  LENGTH  OF  IBUF.  LOGIN  UlC  OFFSET 

INTE0ER«4  OCCOA  ■  ADDR  OF  OFFSPRING  CONTROL  BLOCK  FROM  PARENT 

EQUIVALENCE  (CCCOA. IBUF ( 7 >  ) 
C 

C     BUFFER  IN  WHICH  TO  GENERATE  COHHANOS 
C 

BYTE  BUF<72>  '  KUFFER  IN  WHICH  TO  GENERATE  COHHANDS 

REAL«8  TCMD<2>  "  FOR  CONVENIENCE  IN  ASSIGNMENT  STATEMENTS 

EQUIVALENCE  (BUFiTCHD) 
C 

C     HCR  TASK  NAHE  IN  RAD50 
C 

INTEGER*^  INCR  >  NCR  TASK  NAHE  IN  RAD50 

DATA  INCR/^RNCR. .  ./ 
C 

C  DIRECTIVE  SYMBOLIC  VALUE  DEFINITIONS 
C 

INTEGER*?  OCCCSt  GCCEXi  CCCSTt  GCCND 

DATA  GCCCS.  OCCEX>  GCCe    GCCND  /0>  1>  2>  128/   I  INCP  VALUES  IN  GTCHCI 

DATA  ISCLR  /O/  '  IS.CLR  RETURN  CODE 

INTEGER*2  CMELM.  CMEXT>  CMLKT.  CMRMT   <  TERMINAL  CODES  FOR  SYSTEM  MSOS 

DATA  CHELMf  CMEXTt  CMLKTt  CMRMT  /5t  6t  7f  8/ 
C 

C  CLI  CODE 
C 

C  TO  FORCE  THE  CLI  TO  EXIT  INSTEAD  OF  RETURNING.  THE  GC.CEX  OPTION  IS  SPECI- 
C  FIED  IN  THE  GTCMCI  DIRECTIVE  BELOW.   IF  THE  CLI  IS  INSTALLED  SO  THAT  ONLY 
C  ONE  COPY  OF  THE  TASK  WILL  EXIST  FOR  ALL  TERMINALS.  CHANGE  THE  VARIABLE 
C  GCCEX  BELOW  TO  OCCST.   THIS  SPECIFIES  THE  OC.CST  OPTION  SO  THAT  THE  TASK 
C  WILL  STAY  ACTIVE  BUT  STOPPED  WHEN  NO  COMMANDS  ARE  OUTSTANDING  FOR  IT. 
C 

1     CALL  GTCHCI(CMDBUF>CBLEN>IBUFf IBLEN.0.6CCEX.II    '  GET  CMD  FOR  CLI 

IF  (IDS  .LT.  0>  00  TO  100 
C 

C  IF  THE  GTCMCI  DIRECTIVE  HAD  THE  GC.CST  OPTION  SPECIFIED.  WE  MAY  HAVE 
C  JUST  BEEN  UNSTOPPED.  SO  WE  HAVE  TO  GET  THE  COMMAND. 
C 


IF  (IDS  .EQ.  ISCLR)  60  TO  1 
IF  (OCCDV  .EQ.  0)  GO  TO  200 


I6CCUN  '    GCCUN 

CALL  ASNLUN(S>GCCDVtIGCCUN.IDS) 

IGCCCT-6CCCT 

IF  (lOCCCT  .GE.  0)  00  TO  5 

lOCCCT  «  256  ♦  I6CCCT 
5     IF  (lOCCCT  .LT.  GCCCL )  GOTO  150 
C 

C  AT  THIS  POINT.  THE  CLI  HAS  A  COMMAND  TO  BE  PROCESSED.  THE  CODE  FROn 
C  THE  LABEL  1  TO  HERE  SHOULD  BE  FAIRLY  COMMON  AMONG  ALL  CLIS. 
C  FROM  THIS  POINT  ON.  THE  CODE  WILL  BE  SPECIFIC  TO  THE  PARTICULAR  LANGUAGE 
C  THIS  CLI  IS  IMPLEMENTING.  COMMANDS  CAN  BE  ADDED  OR  DELETED  AT  WILL 


WERE  WE  JUST  UNSTOPPED? 
IS  THIS  A  SYSTEM  MESSAGE' 


CONVERT  BYTE  TO  INTEGER  (UNIT  •) 
ASSIGN  TERMINAL  TO  LUN  5 
CONVERT  BYTE  TO  INTEGER 

CONVERT  NEGATIVE  TO  UNSIGNED 

DID  ENTIRE  COMMAND  FIT  IN  BUFFER? 
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C  BY  HODIFYING  CODE  IN  THIS  SECTION.  AS  STATED  ABOVE'  THIS  EXTREMELY 

C  SIHPLE  CLI  PROVIDES  TWO  COMMANDS*  AND  0!VES  EVERYTHING  ELSE  TO  MCR. 

C  THIS  CREATES  AN  OF'EN-ENDED  ENVIRONMENT.  REJECTINC  UNRECOGNIZED  COMMANDS 

C  INSTEAD  OF  PASSING  THEM  TO  MCR  WOULD  LIMIT  THE  TERMINAL  USER'S  USE  OF 

C  THE  SYSTEM  TO  ONLY  THOSE  OPERATIONS  ALLOWED  DY  THE  CLI.  THIS  IS 

C  A  SECURE  WAY  OF  CONTPOLLINO  SYSTEM  USE >  IN  CASES  WHEN  IT  IS  NECESSAR' 

C  IN  THIS  EXAMPLEf  CHANGING  THE  'GO  TO  50*  BELOW.  TO  A  'GO  TO  60' 

C  WOULD  CREATE  AN  ENVIRONMENT  WHERE  THE  ONLY  OPERATION  A  USER  COULD 

C  PERFORM  WOULD  BE  TO  TYPE  FILES  ON  THE  TERMINAL.  OH    SWITCH  BACK  TO  MCR. 

C  ALL  OF  THE  REST  OF  THE  SYSTEM  IS  INACCESSIBLE.  IF  NO  MEANS  OF  SWITCHING 

C  BACK  TO  MCR  IS  PROVIDED.  IT  IS  IMPOSSIBLE  FOR  THE  USER  TO  DO 

C  ANYTHING  THE  CLI  DOES  NOT  EXPLICITLY  LET  HIM  DO. 

C 

C  IS  IT  A  'T'  COMMAND' 

c 

IF  <<GCCBF(n  ,EQ.  'T')  .AND.  (GCCBF(2)  .EO.  '  ')>  00  TO  10 
C 

C  CHANGE  THE  NEXT  IF  STATEMENT  TO  'GO  TO  60'  TO  ELIMINATE  PASSING  UNKNOWN 
C  COMMANDS  TO  MCR. 
C 

C  IS  IT  ALSO  NOT  AN  'M*  COMMANit* 
C 

IF  <<0w,3F<l)  .NE.  'H')     .OR.  <GCCBF(2)  .NE.  13>)  GO  TO  50  '  M<CR> 
C 

C  THE  USER  HAS  ENTERED  AN  'M'  COMMAND.  SO  SET  THE  TERMINAL  TO  MCR. 
C 

TCMD<1>  «  'SET  /MCR' 

TCMD(2)  '    '«Ti:     '     I  SET  /MCR^YI: 

IGRP  -  IBUFCOCCPUi 1 >     "  (CONVERT  BYTE  TO  INTEGER)  GROUP 

IMEM  =  IBUF(OCCPU>       I  MEMBPR  PART  OF  UIC 
C 

C  ISSUE  RPOIt  DIRECTIVE  TO  EXECUTE  COMMAND 
C 

CALL  RPOKIMCR. IGRP. IMEM f .TCMD. 12. . GCCDV. IGCCUN. .GCCOA.IDS) 

IF  (IDS  .LE.  0)  GO  TO  110  •  ERROR'' 

GO  TO  1  >  BACK  TO  START 

C 

C  THE  USER  HAS  ENTERED  A   f  COMMAND  SO  CONSTRUCT  THE  NECESSARY  PIP 
C  COMMAND  AND  SEND  IT  TO  MCR 
C 

10     TCMD(l)  =  'PIP  Ti:-'      !  PUT  BEGINNr*IG  OF  PIP  CMD  IN  BUFFER 

12  «  8  1  POINTER  INTO  TARGET  BUFFER 

DO  20.  II  -  10.  CBLEN    I  BEGIN  AT  SPACE  AFTER  THE  T  IN  CMDBUF 
IF  (CMDBUFdl)  .EO.  13)  GO  TO  30  !  END  OF  COMMAND''  (<CR,-) 
IF  (CMDBUFdl)  .EQ.  '  ')  GO  TO  20  !  SKIP  ANY  SPACES 
12  >  12  i  1  I  COUNT  CHARACTER 

BUF(I2)  «  CMDBUFdl)   •  COPY  INTO  OUTPUT  BUFFER 
20     CONTINUE 
30     I6RP  «  IBUF(0CCPU+1)     I  (CONVERT  BYTE  TO  INTEGER)  GROUP 

IHEM  «  IBUF(OCCPU)        !  MEMBER  PART  OF  UIC 
C 

C  ISSUE  RPOIt  DIRECTIVE  TO  EXECUTE  COMMAND 
C 

CALL  RPOI ( IMCR. IGRP. IMEM. . TCMD. 12. .GCCDV. IGCCUN. .OCCOA. IDS ) 

IF  (IDS  .LE.  0)  00  TO  110  I  ERRORS 

00  TO  1  !  BACK  TO  START 
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r 

C  IN  THE  ABOVE  SECTION  OF  CODE t  THE  RPOI  DIRECTIVE  WAS  USED  TO  PASS 

C  THE  PIP  CONHAND  TO  THE  NAIN  COHMAND  DISPATCHER  (MCR...)< 

C  WHICH  HILL  START  A  COPY  OF  PIP  AND  OIVE  IT  THE  COHHAND.  THE  RPOI 

C  DIRECTIVE  COULD  BE  USED  TO  GIVE  THE  COHMAND  DIRECTLY  TO  ...PIP  AND 

C  GIVE  THE  RESULTING  TASK  A  DIFFERENT  NAME.  IN  THIS  EXAMPLEf 

C  HE  COULD  CALL  THE  RESULTING  PIP  TASK  'TYPTNN'  HHtRE  THE  LAST 

C  THREE  CHARACTERS  (TNN)  ARE  REPLACED  BY  A  DEVICE  NAHE  CHARACTER  AND 

C  UNIT  NUHBER.  FOR  EXAMPLE »  IF  THE  'T'  COMMAND  WAS  TYPED  ON  TTIO: 

C  THE  RESULTING  TASK  NAME  COULD  BE  MADE  TO  BE  'TYPTIO'.  THIS  HAS  THE 

C  ADVANTAGE  OF  ALLOWING  THE  TASK  TO  BE  ABORTED  BY  AN  'ABO  FYP'  COMMAND' 

C  INSTEAD  OF  'ABO  PIP'I  THUS  THE  USLR  WOULD  NOT  HAVE  TO  KNOW  THAT  THE 

C  'T'  COHMAND  HE  ISSUED  IS  ACTUALLY  BEING  SERVICED  BY  THE  PIP  TASK.  THIS 

C  IS  EXACTLY  WHAT  THE  DCL  CLI  DOES.  IT  IS  NOT  DONE  HERE  IN  ORDER 

C  TO  SIMPLIFY  THE  EXAMPLE.  PICKING  UP  THE  TERMINAL  NAME  AND  UNIT 

C  NUMBERt  CONVERTING  IT  TO  RADSOt  AND  SUPPLYING  IT  IN  THE  RPOI  DIRECTIVE 

C  ALONG  WITH  A  DIRECT  REQUEST  OF  PIP  IS  LEFT  AS  AN  EXERCISE  TO  THE  USER. 

C  (BE  CAREFUL  OH  RSX-llM-PLUS  SYSTEMS  WITH  MORE  THAN  64.  TERMINALS). 

C  NOTE  THAT  REQUESTING  PIP  DIRECTLY  AVOIDS  A  SUBSTANTIAL  AMOUNT  OF  SYSTEM 

C  OVERHEAD. 

C 

C 

C 

C  COMMAND  IS  NOT  'T'  OR  'M'.  SO  GIVE  IT  TO  MCR  AS  IS. 

C 

SO     I6RP  '  IBUFCGCCPUfl >     >  (CONVERT  BYTE  TO  INTEGER)  GAOUF 

IHEM  »  IBUF(GCCPU)       >    MEMBER  PART  OF  UIC 

IGCCCT  =  GCCCT  <  •  OF  CHARS  IN  COMMAND 

C 

C  ISSUE  RPOIt  DIRECTIVE  TO  EXECUTE  COHMAND 
C 

CALL  RPOKIHCRtlGRPiIMEM. tGCCBF f IGCCCT . t GCCDV. IGCCUNi .GCCOA.IDS) 

IF  (IDS  .LE.  0>  GO  TO  110  <  ERROR** 

00  TO  1  <  BACK  TO  START 

C 

C  CONTROL  IS  TRANSFERRED  HERE  IF  UNKNOWN  COMMANDS  ARE  TO  BE  REJECTED 
C  INSTEAD  OF  BEING  PASSED  TO  MCR. 
C 

60     WRITE  (S>62) 

62     FORNAT( 'OILLEGAL  COMMAND') 

GO  TO  1  I  BACK  TO  START 

C 

C  ERROR  HANDLING  CODE 
C 
100     WRITE  (S>102)  IDS        !  ERROR  IN  6TCHCI 
102     FORMAT( 'OFATAL  ERROR  IN  GTCHCI  DIRECTIVE.   DSW>'fI6> 

GO  TO  250  !  EXIT 

C 
110     WRITE  (5fll2>  IDS        I  ERROR  IN  RPOI 
112     FORMAT ( 'OFATAL  ERROR  IN  RPOI  DIRECTIVE.   DSW>'fI6) 

GO  TO  2S0  •  EXIT 

C 
ISO     WRITE  (S>152)  !  ENTIRE  COMMAND  DID  NOT  FIT  IN  BUFFER 

1S2     FORMAT ( 'OSORRYr  PART  OF  YOUR  COMMAND  WAS  lOST) 

00  TO  1  <  BACK  TO  START 
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A    SYSTEM    MESSAGE    HAS    RECEIVED    INSTEAD    OF    A    COMMAMD 


!00 


CONTINUE 

IF  (6CCUN 

.EQ. 

CMLKT) 

00 

TO  210 

1  IS 

IT 

IF  (OCCUN 

.EO. 

CMRMT) 

00 

TO  220 

1  IS 

IT 

IF  (OCCUN 

.EQ. 

CMEXT) 

00 

TO  250 

>     IS 

IT 

IF  <OCCUN 

.EQ. 

CMELM) 

GO 

TO  250 

>  IS 

IT 

oa  TO  1 

1 

1  IGNORE 

ALL 

OT 

A  NEU  TERMINAL  LINKED  TO  US'* 
A  TERMINAL  BEING  REMOWEDT 
AN  ELIMINATE  ALL  PACKET? 
A  CLI  ELIMINATION  MESSAOE' 
OTHER  MESSASEB 


ISSUE  WELCOME  MESSAGE 


210     IGCCUN  -  CMDBUFdl) 

CALL  ASNLUN(SrOCCBF>IGCCUN>IDS) 

URITE  <5i212) 
212     FORMAT < 'OUELCOME  TO  THE  EXAMPLE  CLI) 

00  TO  1  !  BACK  TO  START 


CONVERT  BYTE  TERMINAL  UNIT  •  TO  INTEGER 
ASSIGN  LUN  5  TO  SPECIFIED  DEVICE 


ISSUE  GOODBYE  MESSAGE 


220  IGCCUN  -  CMDBUFdl)  !  CONVERT 
CALL  ASNLUN(SfGCCBF > IGCCUN* IDS)  • 
URITE  (5>222> 

222     FORMAT< 'OGOOD  BYE  FROM  THE  EXAMPLE 


BYTE  TERMINAL  UNIT  •  TO  INTEGER 
ASSIGN  LUN  5  TO  SPECIFIED  DEVICE 

CLI'  ) 


GO  TO  1 


I  BACK  TO  START 


C  UHEN  AN  ELIMINATE  ALL  MESSAGE 
C 
250     CONTINUE 

CALL  EXIT 

END 


IS  RECEIVED.  EXIT  IMMEDIATELY 
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CHAPTER  12 
THE  DCL  tASK 


The  DIGITAL  Command   Language    JCL)   Is   a   general   purpose   command 
language  syntax  implemented  on  several  DIGITAL  operating  systems. 


12.1   INTRODUCTION 

DCL  on  RSX-llM/M-PLUS  systems  is  a  task  that  receives  DCL  commands  by 
means  of  the  generalized  CLI  command  dispatcher,  translates  the  DCL 
commands  to  equivalent  MCR  commands,  and  sends  the  MCR  commands  to  the 
MCR  command  line  interpreter  for  interpretation  and  execution.  The 
DCL  task,  in  conjunction  with  the  CLI  dispatcher,  provides  DCL  support 
on  RSX-llM/M-PLUS  operating  systems. 

This  chapter  explains  the  ways  in  which  DCL  can  be  installed  on  your 
system  and  documents  the  means  by  which  the  DCL  task  parses  and 
translates  commands.  In  addition,  this  chapter  documents  the  Macro 
MetaLanguage ,  a  set  of  MACRO-11  macros  used  to  define  DCL.  An 
experienced  programmer  can  add  commands  to  DCL  or  remove  them,  or 
alter  DCL  by  changing  parts  of  it,  such  as  altering  defaults  or 
eliminating  qualifiers. 

For  information  on  DCL  syntax  and  functions,  see  the  RSX-llM/M-PLUS 
Command  Language  Manual .  For  information  on  MCR  syntax  and  functions , 
see  the  RSX-llM/M-PLUS  MCR  Operations  Manual .  For  information  on  the 
CLI  command  dispatcher,  and  on  alternate  CLIs,  see  Chapter  11,  Command 
Line  Interpreters,  in  this  manual.  For  information  on  the  Executive 
directives  used  to  implement  alternate  CLIs,  see  the  RSX-llM/M-PLUS 
Executive  Reference  Manual . 

The  examples  of  source  code  in  this  chapter  illustrate  features  of  DCL 
and  the  DCL  task,  but  they  are  often  changed  from  the  actual  source 
code  to  make  the  example  clearer.  See  the  DCL  source  code  in  r23,101 
for  exact  information.  The  command  tables  for  the  ASSIGN  command  are 
included  in  this  chapter  (Section  12.ll.<>)  as  a  general  example  of  DCL 
coding . 


12.2   INSTALLING  AND  BUILDING  DCL 

The  DCL  task  is  best  installed  as  an  alternate  CLI,  but  it  ran  also  be 
run  as  a  task  or  installed  as  an  external  MCR  task.  External  MCR 
tasks  have  task  names  in  the  form  ...abc.  Furthermore,  you  can 
rebuild  DCL  either  to  eliminate  direct  access  to  MCR  from  DCL,  or  to 
allow  all  commands  not  in  DCL  syntax  to  fall  through  DCL  for  handling 
by  MCR.  Your  choice  on  these  options  depends  on  the  nature  of  your 
users  and  your  installation. 
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12.2.1   Conventional  Installation  of  DCL  as  a  CLI 

Installing  DCL  as  an  alternate  CLI  is  the  cleanest  use  of  DCL.  This 
allows  you  to  classify  users  by  CLI  in  the  system  account  file.  Users 
can  log  in  using  either  HELLO  or  LOGIN.  The  HELLO  task  checks  the 
account  file  for  the  CLI  and  sets  the  user's  terminal  to  the 
designated  CLI. 

On  RSX-llN  systems,  DCL  and  alternate  CLI  support  require  a  aapped 
systea  with  multiuser  protection.  If  you  choose  DCL  at  system 
generation,  you  are  also  choosing  alternate  CLI  support,  as  DCL  is  an 
alternate  CLI.  In  addition,  choosing  DCL  support  also  gives  you 
support  for  the  following  directives: 

•  Stop-bit 

•  Install-request-remove 

•  Parent-offspring  tasking  with  chaining 
e  AST 

e  Specify  request  exit  AST 

e  Get  task  parameters 

e  Get  command  for  command  interpreter 

e  Request  and  pass  offspring  information 

•  Specify  command  arrival  AST 

•  Get  command  interpreter  information 

The  last  four  directives  listed  are  those  specifically  added  for 
alternate  CLI  support.  See  Chapter  11,  "Command  Line  Interpreters," 
and  the  RSX-llM/M-PLUS  Executive  Reference  Manual . 

During  system  gsnsratlon  on  RSX-llM-PLUS,  you  aro  asktd  if  you  want 
alternate  CLI  support  or  DCL  support.  The  other  (non-CLX)  dlrsctivss 
listed  above  are  supported  on  all  RSX-llN-PLUS  systems  with  the 
full-function  Bxecutlvs. 

Installing  DCL  as  an  alternate  CLI  on  either  RSX-llM  or  RSX-llM-PLUS, 
requires  only  two  commands: 

MCR> INSTALL  $DCL .TSK/CLI =YES 
MCR>CLI  /INIT=DCL 

When  you  choose  DCL  support  during  system  generation,  the  INSTALL 
command  is  issued  in  the  SYSVMR  portion  of  system  generation  and  the 
CLI  /INIT  command  must  be  Included  In  the  system  STARTIJP.CMD  file. 


12.2.2   Alternative  Ways  to  Use  DCL 

If,  for  some  reason,  you  choose  not  to  have  alternate  CLI  support,  you 
can  still  use  many  of  the  features  of  DCL  by  taking  advantage  of 
alternative  ways  of  Installing  DCL.  You  can  run  DCL  as  a  task. 
Install  DCL  as  an  external  MCR  task  under  the  name  ...DCL,  or  Install 
DCL  as  the  system  catchall  task  under  the  name  ...CA. 
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If  DCL  is  not  a  CLT ,  you  cannot  log  in  with  LOGIN,  you  cannot   change 

your   defaults   with   SET   DEFAULT,  breakthrough  writes  do  not  break 

through,  and  spawned  tasks  are  not  renamed.    That   is,   a   DIRECTORY 

command  spawns  a  task  named  PIPTnn,  not  DIRTnn. 


12.2.2.1   Run  DCL  as  a  Task  -  If  you  wish,  you  can  simply  run  DCL  as  a 

task.    If   you  place   the  task  image  file  in  the  system  directory  on 

RSX-llM  or  the  library  directory  on  RSX-UM-PLUS,  users  can   run   DCL 
with  the  command: 

>RUN  $DCL 

DCL  runs  from  your  terminal  as  a  tack.   The  terminal   remains   set   to 

MCR.   All   DCL  commands  work  in  the  normal  way,  but  a  carriage  return 
on  a  line  by  itself  causes  the  task  to  exit. 


12.2.2.2  Install  as  ...DCL  -  T  you  install  the  DCL  task  as  an 
external  MCR  task  under  the  name  ...OCT,  users  can  issue  DCL  commands 
from  an  MCR  terminal  simply  by  preceding  the  command  with  DCL,  as  in 
the  following  example: 

HCR>DCL  SHOW  USERS 


12.2.2.3  Install  as  ...CA.  -  If  you  install  the  DCL  task  under  the 
name  ...CA.,  all  commands  not  recognized  by  MCR  are  handled  by  DCL 
running  as  the  catchall  task.  This  means  that  DCL  commands  such  as 
MOUNT  and  SET  that  are  identical  with  MCR  commands  in  the  first  three 
characters  must  be  in  MCR  syntax.  These  commands  in  DCL  syntax  are 
recognized  by  MCR,  but  only  as  errors.  To  avoid  infinite  loops,  the 
DCL  installed  as  MCR's  catchall  must  not  be  built  with  MCR  as  its 
catchall . 


12.2.3  The  MCR  Command 

The  MCR  command  is  included  in  the  default  DCL  task.  This  command 
permits  users  to  issue  a  one-line  MCR  command  without  leaving  DCL. 
The  MCR  command  is  not  affected  by  SET  DEBUG. 

Some  installations  may  prefer  not  to  permit  DCL  users  any  access  to 
MCR.  If  you  wish  to  restrict  access  to  MCR,  you  must  modify 
DCLBLD.CMD  following  the  instructions  contained  therein  and  then 
rebuilo  DCL. 


12.2.4   Allowing  Unrecognized  Commands  to  Pall  Through  to  NCR 

The  default  DCL  task  returns  an  error  for  any  command  not  recognized 
as  a  DCL  command.  You  may  prefer  that  DCL  allow  any  unrecognized 
commands  to  fall  through  to  MCR  for  another  chance  at  execution.  This 
permits  users  direct  access  to  MCR  tasks  and  utilities  without  using 
the  MCR  command  or  the  RUN  command. 

If  you  wish  to  allow  commands  to  fall  through  DCL  to  MCR,  modify 
DCLBLD.CMD  following  the  instructions  containrd  ^hprpin  ^t.rl  t:V>«?n 
rebuild  DCL. 
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12.2.5   Plying  Installs 

Tasks  need  not  be  Installed  for  DCL  to  access  them.  Comments  In 
DCLBLD.CMD  explain  how  to  enable  flying  installation  of  tasks.  Again, 
modify  DCLBLD.CMD  and  rebuild  DCL. 


12.2.*;  Task-Building  DCL 

All  of  the  changes  to  DCL  described  in  this  chapter  require  that  the 
DCL  task  be  rebuilt.  This  tasK  build  actually  requires  two  passes  by 
the  Task  Builder  before  it  is  complete.  The  first  pass  creates  a 
symbol  table  (.STB  file)  that  is  used  by  TKB  on  the  second  pass  to 
build  the  DCL  task. 

The  file  f 1 , 24 1DCLBLD.CMD  is  called  by  SYSGEN  when  you  request  DCL 
support.  You  should  read  this  file  before  attempting  to  task-build 
DCL. 

The  overlay  structure  of  the  DCL  task  forces  a  complex  task  build. 
There  is  more  detail  about  how  the  DCL  task  works  in  the  next  section, 
but  here  is  an  outline  of  the  situation.  Each  DCL  command  is  defined 
in  a  parser  table,  or  PT,  which  defines  the  DCL  syntax  of  the  command. 
The  PT  is  paired  with  a  translator  table,  or  TT,  which  defines  the  MCR 
equivalents  for  the  DCL  command.  The  addresses  of  the  PT  and  TT  are 
included  in  a  master  command  table  (MCT)  that  lists  all  DCL  commands. 
When  DCL  parses  a  command,  it  seeks  the  address  of  that  command  in  the 
MCT  and  then  goes  to  that  address  for  translation  of  the  command  to 
MCR  at  the  PT/TT.  The  parser  tables  and  translator  tables  are 
overlaid  on  the  master  command  table.  This  means  that  at  the  time  of 
th3  first  task  build,  the  master  command  table  entries  are  undefined 
symbols.   The  following  summarizes  the  process. 

The  first  task  build  uses  a  command  in  the  following  form: 

>TKB  , ,DCL.STB=DCL 

This  results  in  one  or  more  undefined  symbols  for  each  command,  but 
the  PT/TT  addresses  for  each  command  are  in  the  .STB  file. 

The  second  task  build  uses  a  command  in  the  following  form: 

>TKB  DCL,DCL=DCL,DCL.STB 

The  master  command  table  symbols  are  defined  by  means  of  the  .STB  and 
the  ac^'  resses  in  the  PT/TT  are  doubly  defined,  once  in  the  .STB  and 
once  Ir.  their  overlays.   The  two  definitions  are  identical. 

In  fact,  this  process  is  accomplished  through  two  .ODL  files.  See 
DCLBLD.CMD  for  more  information. 


12.2.7  How  the  DCL  Task  Works 

There  are  three  processes  involved  in  interpreting  DCL  commands  —  the 
receive  process,  the  parser/tianslator  process,  and  the  send  process. 
The  receive  process  gets  the  command  line  from  the  system.  The 
table-driven  parser/translator  process  translates  the  command  line  to 
g'i  equivalent  MCR  command  line.  The  send  process  sends  th'i  equivalent 
MCR  command  line  to  the  system  for  further  interpretation  and 
execution. 
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The  receive  process  involves  two  tasks:  the  CLI  dispatcher  task 
(HCR...)  and  the  DCL  task  (...DCL).  The  CLI  dispatcher  task  gets  the 
command  line  from  the  terminal  driver,  queues  it  to  a  CLI  queue,  and 
activates  the  DCL  task  (if  not  already  active).  The  DCL  task 
activated  is  named  DCLTnn,  where  nn  is  the  number  of  the  issuing 
terminal.  The  DCL  task  (being  nonpr i vileged)  issues  the  Get  Command 
for  Command  Interpreter  (GCCIS)  directive  to  remove  (or  receive)  the 
command  line  from  the  CLI  queue. 

The  parser /translator  process  involves  two  subprocesses:  the  parser 
process  and  the  translator  process.  The  parser  process  checks  syntax 
to  ensure  that  the  received  command  line  is  a  valid  DCL  command  line. 
The  parser  constructs  an  intermediate  form  (/FORM)  to  pass  data  about 
the  command  line  to  the  translator.  The  translator  process  uses  this 
data  to  construct  an  equivalent  MCR  command  line  from  the  valid  DCL 
command  line. 

The  send  process  dispatches  the  equivalent  MCR  command  line  to  MCR  or 
MCR  utility  tasks  by  means  of  the  Request  and  Pass  Offspring 
Information  (RPOI$)  directive.  The  RPOIS  directive  is  functionally 
similar  to  the  SPWNS  directive.  There  are  t,ro  significant  differences 
from  SPWNS:  RPOIS  allows  the  spawned  task  to  be  named  (for  example, 
spawn  PIP  and  name  it  COPTnn) ,  and  RPOIS  does  not  create  OCBs 
(Offspring  Control  Blocks) . 

The  DCL  task  needs  the  task-naming  ability  to  track  the  association 
betwean  r.h«?  DCL  command  name  and  the  MCR  or  utility  task  that  executes 
the  comm<=>n'1.  A.nd ,  instead  of  creating  an  OCB,  RPCIS  takes  the  OCB 
attached  to  the  DCL  task  and  attaches  this  OCP  to  the  spawned  task. 
Thia  enables  the  spawned  task  to  communicate  exit  status  directly  to 
the  parent  task,  DCL.  In  this  way,  the  DCL  task  can  spawn  a  task 
without  having  to  wait  for  the  task  to  exit. 

The  remainder  of  this  document  describes  how  to  construct  the  DCL 
command  tables,  which  drive  the  parser/translator  process.  Basically, 
t^e  tables  contain,  for  each  DCL  command,  the  syntax  of  the  DCL 
command,  the  syntax  of  the  equivalent  MCR  command  (that  is,  the  syntax 
of  the  MCR  command  that  the  uCL  command  translates  to) ,  and  the 
relation  (or  mapping)  between  the  DCL  syntax  and  the  MCR  syntax. 
MACRO-11  macros  and  rules  define  the  tables.  The  macros  and  rules 
form  a  language  designed  to  allow  the  user  to  express  the  tables. 

The  macros  and  rules  are  called  the  Macro  MetaLanguage  (MML) .  Here  is 
a  list  of  some  of  the  features  of  the  language  and  how  they  are 
employed  in  the  DCL  task: 

•  MML  is  modeled  after  a  Backus-Naur  Form  (BNF)  metalanguage.  A 
BNF  language  specifies  which  sequences  of  symbols  constitute  a 
syntactically  valid  statement  in  a  given  language.  In  this 
case,  MML  is  used  to  describe  the  proper  syntax  of  a  DCL 
command  and  the  equivalent  syntax  of  an  MCR  command. 

•  ;^ML  allows  the  specification  of  a  prompt  string  for  each 
syntax  element.  DCL  prompts  for  more  input,  with  the 
specified  string,  if  a  test  for  end-of-line  is  successful. 

•  MML  interfaces  with  the  RSX-llM/M-PLUS  HELP  facility.  The 
user  requests  help  by  typing  a  "?"  character  in  reply  to  a 
prompt . 

•  MML  allows  the  specification  of  an  error  message  string  for 
each  syntax  element.  If  DCL  detects  an  error  while  processing 
a  syntax  element  and  that  syntax  element  has  a  specified  error 
message,  DCL  issues  the  error  message  and  aborts  the  parse. 
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•  MML  allows  the  specification  of  contradictory  bit  masks  for 
each  syntax  element.  DCL  uses  the  bit  masks  to  detect 
contradictory  syntax. 

•  UML  allows  the  use  of  globally  defined  syntax  elements,  such 
as  filespecs,  device  specs,  numerals,  letters,  alphanumer ics 
and  so  forth. 

•  MML  allows  MACRO-11  Assembly  Language  subroutines  to  be  mixed 
with  MML  statements  in  the  event  that  a  command  cannot  be 
completely  defined  using  MML. 

•  MML  allows  one  DCL  command  to  translate  to  more  than  one  MCR 
command.  For  instance,  the  DCL  SET  DEFAULT  command  can 
generate  both  an  MCR  ASN  command  and  an  MCR  SET  /UIC  command. 

•  MML  supports  floating  qualifiers.  A  floating  qualifier  can  be 
specified  anywhere  in  the  command  line. 

The  following  section  describes  the  DCL  command  tables.  The  DCL 
command  tables  define  all  DCL  commands  and  are  written  in  MML.  See 
Sections  12.6  through  12.10  for  more  information  on  MML. 


12.3   DCL  COMMAND  TABLES 

The  parser/translator  process  of  DCL  is  table-driven.  A  master 
command  table  (MCT)  contains  an  entry  for  each  DCL  command.  Each 
entry  in  the  MCT  contains  the  name  (verb)  of  the  command,  the  address 
of  a  parser  table  (PT)  for  the  command,  the  address  of  a  translator 
table  (TT)  for  the  command,  and,  optionally,  the  name  of  the  overlay 
containing  the  PT  and  the  TT.  Thus,  there  is  a  PT  and  a  TT  for  each 
DCL  command.  Each  PT/TT  contains  the  information  that  the 
parser/translator  process  needs  to  translate  a  DCL  command  line  to  an 
equivalent  MCR  command  line.  For  ease  in  adding  and  modifying 
commands,  MCT  and  each  PT/TT  are  kept  in  separate  files. 

The  file  for  the  MCT  is  called  COMMAND. MAC.  The  files  for  the  PT/TTs 
are  named  after  the  DCL  command,  with  the  type  .MAC.  For  example,  the 
PT/TT  for  the  DCL  COPY  command  is  in  a  file  named  COPY. MAC. 

The  DCL  task  uses  MCT  to  recognize  an  arbitrary  command  and  to  locate 
the  PT/TT  for  that  command.  MCT  consists  of  calls  to  the  COMMAND 
macro.  There  is  a  COMMAND  macro  for  each  DCL  command.  Arguments  to  a 
COMMAND  macro  specify  the  name  (or  verb)  of  the  command,  the  address 
of  the  PT  for  the  command,  the  address  of  the  TT  for  the  command,  and 
the  overlay  name  for  the  command. 

The  PT/TTs  drive  the  parser/translator  process.  The  parser/translator 
process  ensures  that  the  syntax  of  the  DCL  command  line  is  correct  and 
creates  the  /FORM,  which  is  the  parser  subprocess,  and  subsequently 
contructs  equivalent  MCR  command  lines,  which  is  the  translator 
subprocess.  The  PT  drives  the  parser  subprocess  and  the  TT  drives  the 
translator  subprocess.  The  PT  is  an  MML  definition  of  the  syntax  or 
structure  of  the  DCL  command  and  the  TT  is  an  MML  definition  of  the 
syntax  or  structure  of  the  corresponding  MCR  command. 

Table  12-1  shows  the  structure  of  the  DCL  command  table  files. 

The  PT  defines  the  syntax  for  a  DCL  command  line.  The  TT  defines  the 
syntax  for  the  corresponding  MCR  command  line.  For  the  translator  to 
know  which  particular  MCR  command  line  to  contruct  from  a  particular 
DCL  command  line,  the  PT  and  the  TT  must  express  a  relation  between 
the  DCL  syntax  and  the  MCR  syntax. 
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Table  12-1 
DCL  Command  Tables 


COMMAND , MAC 

ABORT. MAC 

UNLOCK. MAC 

Master  Command  Table 

COMMAND  ABORT   ABOPT  ABOTT 
COMMAND  ASSIGN  ASSPT  ASSTT 

• 
• 
• 

COMMAND  UNLOCK  UNLPT  UNLTT 

ABOPT: ! 

Parser 

Table 

UNLPT:: 

Parser 
Table 

ABOTT: : 

Translator 
Table 

UNLTT: : 

Translator 
Table 

T^e  PT/TT  expresses  this  relation  by  mapping  elements  from  DCL  syntax 
to  elements  in  MCR  syntax.  For  example,  the  DCL  qualifier  "/GLOBAL" 
maps  to  the  MCR  switch  "/GBL"  (that  is,  the  switch  "/GBL"  is  output 
when  the  qualifier  "/GLOBAL"  is  input). 

The  parser  passes  the  mapping  information  to  the  translator  by  means 
of  a  dynamic  data  structure  called  the  Intermediate  Form  (IFORM) .  The 
parser  constructs  the  IFORM  and  the  translator  examines  the  IFORM. 
The  IFORM  contains  the  essential  information  that  the  translator  needs 
to  contruct  the  equivalent  MCR  command  line.  Both  the  PT  and  the  TT 
define  the  mapping  from  DCL  to  MCR  syntax. 

The  Macro  MetaLanguage  (MML)  defines  the  PT  and  the  TT.  MML  is  a  set 
of  MACRO-11  macros  and  rules  implementing  a  language  in  which  a  user 
can  define  DCL  commands.  With  MML,  a  user  can  express  the  information 
in  the  PT  and  the  TT  in  a  BNF-type  metalanguage. 

The  following  section  describes  the  structure  of  the  file  that 
contains  the  MCT  and  of  the  files  that  contain  the  PT/TTs .  It  also 
describes  how  these  files  assemble,  overlay,  and  task  build  into  the 
DCL  task.   Section  12.4.1.1  describes  how  to  create  the  PTs  and  TTs . 


12.4   MODIFYING  DCL  COMMAND  TABLES 

A  DCL  command  consists  of  an  entry  in  the  master  command  table  (MCT) , 
a  parser  table  (PT)  ,  and  a  translator  table  (TT) .  The  PT  defines  the 
syntax  of  the  DCL  command.  The  TT  defines  the  syntax  of  the 
corresponding  MCR  command.  The  entry  in  the  MCT  connects  the  PT  and 
the  TT  to  the  DCL  task.  Thus,  to  add  a  new  command  to  the  DCL  task 
the  user  must  construct  a  PT  and  a  TT  and  make  an  entry  in  the  MCT. 


12.4.1  Adding  Conmands 

Adding  a  command  to  the  DCL  task  involves: 

1.  Creating  the  PT  and  the  TT 

2.  Creating  the  file  that  contains  the  PT  and  the  TT 

3.  Making  an  entry  in  the  MCT 
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4.  Making  an  entry  in  the  overlay  description  file  for   the  DCL 
task 

5.  Incorporating  the  new  PT/TT  file  and  the   modified   MCT   file 
into  the  DCL  task 


12.4.1.1   The  PT/TT  File  -  The  file  that  contains  the  PT  a 
named   after   the   verb   of   the  command.   The  file  type 
example,  the  PT  and  the  TT  for  the  COPY  command  are  in   a 
COPY. MAC) .    The   PT/TT   file   must   specify  the   MACRO- 
directives  .TITLE,  .PSECT,  and  .END.   The  title  of  the  fil 
as   an   argument  to  the  .TITLE  directive)  must  also  be  the 
verb  of  the  command.   Normally,  the   program-section  name 
which   stands    for   command   definition.    If,   howeve 
subroutines  are  interspersed  with  MML  notation  by  means   o 
predefined   syntax   element,   the   subroutines  must  be 
program  section.   (See  Section  12.11  for  details  on  $JSR.) 


nd  the  TT  is 
is  .MAC  (for 

file  named 
11  assembly 
e  (specified 

same  as  the 

is   .CDEF, 

r,   MACRO- 11 

f   the   $JSR 

in  the  blank 


In  addition  to  these  directives,  the  PT/TT  file  must  contain  a 
(MACRO-11)  global  label  on  the  first  MML  macro  of  the  PT  and  a  global 
label  on  the  first  MML  macro  of  the  TT.  By  convention,  the  label  on 
the  PT  is  the  same  as  the  verb  of  the  DCL  command,  and  the  label  on 
the  TT  is  the  same  as  the  verb  on  the  corresponding  MCR  command.  The 
following  shows  the  structure  of  the  file  that  contains  the  PT  and  the 
TT  for  tne  DCL  ASSIGN  command. 


ASSIGN. MAC 

.TITLE   ASSIGN 

•PSECT   .CDEF 

ASSIGN: : 

Parser  Table 

ASN:  : 

Translator  Table 

.END 

The  two  global  labels  in  the  PT/TT  file  connect  the  PT  and  the   TT 
the  DCL  task.   This  is  accomplished  by  making  an  entry  in  the  MCT. 


to 


12.4.1.2  The  NOT  Entry  -  The  file  COMMAND. MAC  contains  the  master 
command  table  (MCT).  The  MCT  consists  of  a  list  of  (MACRO-11)  COMMAND 
macrocalls.  Each  COMMAND  macrocall  identifies  a  DCL  command.  The 
list  of  COMMAND  macrocalls  is  ordered  alphabetically  by  the  name  or 
verb  of  the  command.  The  COMMAND  macro  takes  five  arguments.  The 
first  four  are  mandatory  and  the  ^ifth  is  optional.  The  format  for 
the  COMMAND  macro  is  as  follows: 


COMMAND   name,  min,  ptaddr,  ttaddr,  (ovrnami 


where 


name      Name  or  verb  of  the  command 

min       Minimum  number  of  characters  necessary  to  make  the  name 
unique 
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ptaddr    Label  of  the  PT  for  the  command 

ttaddr    Label  of  the  TT  for  the  command 

[ovrnaml   Three-character  name  of  the  overlay  for  the  PT  and  TT 

The  fifth  argument  to  the  COMMAND  macro  (ovrnam)  is  optional.  The  PT 
and  TT  must,  however,  be  in  an  overlay  whether  or  not  you  specify  this 
argument.  The  default  overlay  name  is  the  command  verb,  assuming  the 
PT  and  TT  are  In  the  same  module.  If  they  are  in  separate  modules, 
the  PT  overlay  is  named  for  the  verb  by  default,  and  the  TT  la  named 
for  the  verb  preceded  by  a  "T"  (for  example,  TSET.MAC) . 

The  MCT  is  in  two  parts.  Part  1  of  the  MCT  includes  all  DCL  command 
verbs  in  alphabetical  order,  as  described  in  this  section.  Part  1  is 
searched  with  a  binary  search  algorithm.  Part  2  of  the  MCT  makes 
possible  the  brief  forms  of  commonly  used  DCL  commands.  If  the  search 
of  Part  1  for  a  command  verb  fails  —  if  a  line  is  too  short,  for 
instance  —  a  search  of  Part  2  is  initiated.  Part  2  is  not 
necessarily  in  alphabetical  order  as  It  is  searched  from  the  top  down. 


12.4.1.1   The  Overlay  Entry  -  Each  PT/TT  must  reside   in   an  overlay. 
Use  one  of  the  following  structures  to  overlay  a  PT/TT: 

1.  One  overlay  for  two  or  more  PT/TTs 

2.  One  oveilay  for  one  PT/TT 

3.  Two  overlays  for  one  PT/TT 

4.  More  than  two  overlays  for  one  PT/TT 

Specify  an  overlay  by  making  an  entry  in  the  overlay  description  files 
DCLBLD.ODL  and  DCDBLD.ODL  —  and  connect  the  new  overlay  entry  to 
the  root  segment  overlay  entry.  For  the  first  type  of  overlay 
structure  previously  noted  (one  overlay  for  two  or  more  PT/TTs) ,  the 
format  for  the  overlay  entry  is  as  follows: 

.NAME   ovrnam 
label:   .FCTR   ovrnam-DCLO/LB;cmdriaml  :cmdnam2. .  .  :cmdnamn-L 

where 

label   Connects  the  entry  to  the  root  segment 

ovrnam  Three-character  name  of  the  overlay 

DCLO    Object  library  containing  the  modules  in  the  overlays 

cmdnaml  Title  of  the  file  containing  the  first  PT/TT 

cmdnam2  Title  of  the  file  containing  the  second  PT/TT 


cmdnamn  Title  of  the  file  containing  the  last  PT/TT 

For  each  entry  In  the  MCT  whose  command  tables  (PT/TTs)  are  In  an 
overlay  that  has  two  or  more  PT/TTs,  you  must  Include  the  overlay 
name,  ovrnam. 
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For  the  second  overlay  structure  previously  noted  (one  PT/TT  per 
overlay),  the  entry  has  the  following  format: 

label:  .FCTR  DCLO/LB:cmdnam-L 

where 

label  Connects  the  entry  to  the  root  segment 

cmdnam  Title  of  the  file  that  contains  the  PT/TT 

This  structure,  one  overlay  and  one  PT/TT,  does  not  specify  the 
overlay  name.  In  this  case,  the  DCL  t?sk  uses  the  name  or  verb  of  the 
command  as  the  overlay  name  since  the  Task  Builder  default  for  the 
overlay  name  is  the  title  of  the  file.  For  this  reason,  the  title  of 
the  file  containing  the  PT/TT  must  be  the  same  as  the  name  or  verb  of 
the  command. 

For  the  third  overlay  structure  (two  overlays  and  one  PT/TT),  the 
entry  has  the  following  format: 

label:   .FCTR  (DCLO/LB:cmdnam-L,DCLO/LB: tcmdnam-L) 

where 

label    Connects  the  entry  to  the  root  segment 

cmdnam  Title  of  the  file  that  contains  the  PT 

tcmdnam  Title  of  the  file  that  contains  the  TT 

Note  that  this  overlay  structure,  two  overlays  and  one  PT/TT,  requires 
that  the  PT  and  TT  reside  in  separate  files.  The  separate  files  have 
the  same  format  as  a  single  file  that  contains  the  PT/TT  except  that 
there  is  only  one  global  label  in  each  file.  By  convention,  the  file 
containing  the  PT  is  named  for  the  verb  of  the  command  and  the  file 
containing  the  TT  is  named  for  the  verb  prefixed  by  "T".  The  titles 
of  the  files  follow  the  same  convention.  For  example  the  file 
containing  the  PT  for  the  DCL  SET  command  is  named  SET. MAC  with  title 
SET,  and  the  file  conta  .ling  the  TT  for  the  DCL  SET  command  Is  named 
TSET.MAC  with  title  TSET. 

For  the  fourth  overlay  structure  (more  than  two  overlays  and  one 
PT/TT),  the  entry  has  the  following  format: 

label:   .FCTR 

(DCLO/LB: cmdnam- L,DCLO/LB: tcmdnam-L, DCLO/LB:ovrnaml-L) 

where 

label   Connects  the  entry  to  the  root  segment 

cmdnam  Title  of  the  file  that  contains  the  PT 

tcmdnam  Title  of  the  file  that  contains  the  TT 

ovrnaml  Title  of  a  file  containing  more  parts  of  the  PT/TT 

Basically,  the  overlay  structure  of  more  than  two  overlays  and  a 
single  PT/TT  allows  a  PT  or  a  TT  to  Invoke  additional  overlays 
containing  additional  portions  of  the  PT  or  TT.  Since  the  PT  and  TT 
are  read-only  data,  the  additional  overlay  segments  are  load«>d  on  top 
of  the  overlay  that  is  invoking  them.    On   return   from   the   invoked 
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overlay,  the  DCL  task  reloads  the  previous  overlay.  Control  returns 
to  the  point  in  the  previous  overlay  whence  the  additional  overlay  was 
invoked . 

Use  the  SCALLOV  predefined  syntax  element  to  invoke  additional 
overlays  from  a  PT  or  a  TT.  (See  Section  12.11,  for  details  on  the 
SCALLOV  predefined  syntax  element.)  To  specify  additional  overlays, 
repeat  the  format  above.  That  is,  for  each  additional  overlay, 
specify  an  additional  argument  to  the  .FCTR  directive  using  the 
format:   DCLO/LB:ovrnam-L. 

Next,  connect  the  new  overlay  entry  to  the  root  segment  of  the  DCL 
task  by  adding  the  label  of  the  entry  to  the  list  of  labels  for  ether 
entries.  The  list  of  labels  for  other  entries  Is  found  In  the  overlay 
description  file  after  the  label  OLAY.  By  convention,  enter  the 
labels  In  alphabetical  order.  The  following  shows  the  list  of  overlay 
entry  labels: 

OLAY:    .FCTR  { 1 1 , 1 2 , 11 , 14 , 1 5 , . . . , In) 

where 

ll,...,ln  Labels  of  overlay  entries 

Note  that  since  there  are  two  overlay  description  files  for  building 
the  DCL  task  (DCLBLD.ODL  and  DCDBLD.ODL),  you  must  make  new  overlay 
entries  In  both  files.  The  format  Is  the  same  for  both  overlay 
description  files.  For  details  on  how  to  build  the  DCL  task,  see 
Section  12.2.  For  details  on  overlay  structures,  see  the 
RSX-llM/M-PLUS  Task  Builder  Manual. 

The  last  step  required  to  add  a  command  to  the  DCL  task  Is  to 
Incorporate  all  created  or  modified  files  Into  the  DCL  task. 


12.4.1.4  Incorporating  the  PT/TT  and  MCT  -  The  last  step  In  adding 
new  commands  to  DCL  —  assembly  and  task  building  --  Is  accomplished 
through  the  Indirect  command  file  r 23 , 241 DCL.CMD,  which  Is  on  the  same 
disk  as  the  DCL  sources.  This  file  prompts  for  the  name  of  a  file 
containing  the  names  of  all  modules  you  have  changed  or  created.  The 
input  file  consists  of  one  module  name  per  line,  with  no  file  type  or 
version  number.  DCL.CMD  then  assembles  the  modules,  updates  the 
object  libraries,  and  task-builds  the  new  version  of  DCL. 

Invoke  DCL.CMD  as  follows: 

>§DCL 

*Do  you  want  expanded  comments;   [Y/Nl : 

Answer  Y  to  this  question.  The  comments  in  DCL.CMD  direct  the 
remainder  of  the  process. 

If  all  source  files  assemble  correctly,  DCL.CMD  then   builds   the  DCL 

task.   See  Section  12.2  for  information  on  how  to  determine  If  the  DCL 

task  was  built  correctly  and  for  information  on  how  to  Install  DCL  as 
a  CLI  In  a  multi-CLI  environment. 

The  DCL.CMD  command  file  Is  designed  to  run  under  MCR  with  MAC,  LBR, 
PIP,  and  TKB  Installed.  DCL.CMD  Is  designed  to  run  using  one  UFD,  the 
UFD  that  you  Invoke  tJie  command  file  from.  Tbl^  means  that  the 
following  files  must  be  in  this  UFD: 

•   Specified  source  files 
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Library  files  for  DCL:   DCLO.OLB  and  DCLR.OLB,  the  overlay  and 
root,  respectively, 

Prefix  files  for  DCL:   OCLMAC.MAC  and  COMMAC.MAC 

Task-build  command  file:   DCLBLD.CMD 

Overlay  description  files:   DCLBLD.ODL  and  DCDBLD.ODL 


Additionally,  RSXMC.UAC  must  be  in  LB: [11,101.  Although  DCL  is 
nonprivileged ,  DCL  needs  this  file  to  deter.nine,  at  assembly  time, 
whether  your  system  is  RSX-llM  or  RSX-1 IM-PLUS. 


12.4.2  Deleting  Commands 

To  delete  a  command  from  DCL,  you  must  break  the  link  between  the  MCT 
and  the  PT/TT.  To  do  this,  delete  the  appropriate  COMMAND  macro  entry 
in  the  MCT,  which  is  in  the  file  COMMAND. MAC.  Then  incorporate  the 
modified  COMMAND. MAC  file  into  the  DCL  task  by  following  the  procedure 
outlined  in  the  preceding  section.  You  can  also  delete  the  entiy  in 
the  overlay  desciiption  files  and  the  object  modules  for  the  PT/TT  in 
the  DCLO.OLB  library,  but  this  is  optional. 


12.4.3  Modifying  Commands 

Modifying  an  existing  DCL  command  involves  modifying  the  PT/TT  files 
to  reflect  the  desired  change  and  Incorporating  the  modified  files 
into  the  DCL  task,  as  described  in  Section  12.4.1. 

The  user  defines  DCL  PTs  and  TTj  using  MML.  The  following  section 
describes  a  metalanguage  in  general  terms,  using  a  simple  English 
sentence  as  the  example.  Following  the  introduction  of  these  general 
concepts  in  Section  12.5  is  a  more  detailed  exposition  of  the  Macro 
MetaLanguage  (MML)  itself  in  Section  12.6.  For  instance,  the  general 
introduction  in  Section  12.5  includes  a  description  of  ANDing  and 
ORing  in  metalanguages,  while  Section  12.6  describes  the  AND  and  OR 
macros  of  the  Macro  MetaLanguage. 


12.5   A  GENERAL  DESCRIPTION  OP  A  METALANGUAGE 

Consider  a  sentence  in  the  English  language.   A   syntax   tree   defines 
the  structure  or  syntax  of  a  sentence  as  shown  below: 


<sentence> 


<sub ject> 

I ^ 1 

<article>  <adjective>  <noun> 


THE 


OLD 


I 
MAN 


1 

<predicate> 

I 


<verb>    <direct 
I 
WALKED    


object> 


<article> 

I 
THE 


I 
<nounl> 

I 
DOG 
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Note  that  the  sentence  "The  old  man  walked  the  dog"  is  one  of  many 
sentences  that  could  fit  the  above  structure  (syntax).  The  following 
description  of  the  syntax  tree  is  a  metalanguage  definition  of  the 
sentence: 


sentence 

subject 

predicate 

direct  object 

article 

adjective 

noun 

verb 

nounl 


:-  <subject>  <predicate> 

!■  <article>  <adjectlve>  <noun> 

;■  <verb>  <direct  object> 

:»  <article>  <nounl> 

:-  THE 

:-  OLD 

;-  MAN 

:>  WALKED 

:»  DOG 


Note  the  equivalence  of  the  metalanguage  definition   and   the   syntax 
tree.   They  describe  the  same  thing.   Note  also  that  the  metalanguage 


definition  uses  the  symbols  "<' 


and 


The  symbols  "<"  and  ">"  denote  category  references.  These  symbols 
enclose  the  name  of  the  category.  Categories  dt  fine  classes  of 
objects.  For  example,  the  category  <rubject>  defines  English  words 
that  fit  the  structure  of  an  <article>  followed  by  an  <adjective> 
followed  by  a  <noun>. 


The  symbol 


means  "is  defined  as"  and  denotes  a  production  rule. 


In  a  production  rule,  you  specify  the  category  name  to  the  left  of  the 
":;="  symbol  and  the  definition  for  the  category  to  the  right  of  the 
":;="  symbol.  A  category  reference  means  there  is  a  production  rule 
for  the  category  that  requires  that  the  right  part  of  the  production 
rule  be  substitued  for  the  name  of  the  category.  For  example,  here  is 
the  production  rule  for  <subject>: 

subject  ::=  <article>  <adjective>  <noun> 

that  references  the  category  <adjective>.  The  production  rule  for  the 
category  <adjective>  is: 

adjective  ::=  OLD 

Thus,  you  can  rewrite  the  production  rule  for  <subject>  as  follows: 

subject  ::=  <article>  OLD  <noun> 

Note  that  you  can  also  substitute  further  for  references  to  the 
categories  <article>  and  <noun>  to  produce  the  production  rule: 


subject 


THE  OLD  MAN 


You  cannot  substitute  for  the  words:  THE,  OLD,  and  MAN.  These  words 
are  literal  strings.  For  simplicity,  literal  strings  are  called 
literals,  and  category  references  are  called  nonliterals.  A  category 
definition  (the  right  part  of  a  production  rule)  consists  of  literals 
and  nonliterals,  or  both,  concatenated  by  impl ied-ANDs. 
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The  implied-AND  has  no  symbol   in  the   metalanguage   (thus   the   term 

implied).    Use   the   implied-AND  to   form   category   definitions   by 

concatenating  arbitrary  numbers  of  syntax  elements.  A  syntax  element 
is   either   a   literal   or  a  nonliteral.   For  example,  in  the  category 

definition    for    <subject>    are  three    nonliterals  --  <article>, 

<adjective>,  and  <noun>.  An  implied-AND  concatenates  these 
nonliterals. 

Two  additional  notations  in  the  metalanguage  are: 

Exclusive-OR  indicator         | 

Optional  syntax  indicators     (1 

Use  the  exclusive-OR  indicator  "I"  to  show  that  a  category  can  be 
defined  in  several  ways.  For  example,  here  is  the  production  rule  for 
the  category  <adjective>. 

adjective  ::=  OLD  I  YOUNG  I  MIDDLE-AGED 

When  substituting  for  a  nonliteral  with  more  than  one  definition 
(separated  by  "I"),  use  only  one  of  the  definitions  in  the 
substitution.  For  example,  substituting  for  the  nonliteral 
<adjective>  defined  in  this  way  in  the  production  rule  for  <subject> 
yields  one  of  the  following  three  production  rules: 

subject  ::=  THE  OLD  MAN 

or 
subject  ::=  THE  YOUNG  MAN 

or 

subject  ::=  THE  MIDDLE-AGED  MAN 

The  square  brackets,  "["  and  "1",  enclose  optional  syntax.  For 
example,  the  following  productiorv  rule  defines  the  category  <subject>. 

subject  ::=  <article>  f  <adjective>  ]    <noun> 

The  square  brackets  around  the  nonliteral  <adjective>  indicate  that 
<adjective>  is  optional  syntax.  This  would  allow,  by  means  of 
substitution,  rewriting  the  production  rule  for  <subject>  to  either: 

subject  ::=  <article>  OLD  <noun> 

or 

subject  ::=  <article>  <noun> 

In  addition  to  denoting  optional  syntax,  the  square  brackets  also 
indicate  iteration.  That  is,  syntax  denoted  as  optional  can  also  be 
used  repeatedly  to  define  the  syntax.  For  example,  if  the  following 
defines  <adjective>: 

adjective  ::*   MEAN  |  OLD  I  FAT 

then  you  could  rewrite  the  production  rule  for  <subject>  (if  <subject> 
is  defined  with  "F"  and  "]"  as  above)  to: 

subject  ::=  <article>  MEAN  OLD  FAT  <noun> 
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Note,  the  repeated  substitution  for  the  nonliteral  <ad jective> . 

Thus,  you  can  use  the  symbols,  rules,  and  logic  described  above  as  a 
language  (that  is,  as  a  metalanguage)  to  define  the  structure  of  other 
languages.  The  structure  or  syntax  of  a  language  is  called  the 
grammar  of  that  language.  The  grammar  is  used  to  determine 
mechanically  whether  an  arbitrary  sentence  is  a  sentence  in  the 
language. 

Our  interest  here  is  in  the  grammars  for  DCL  and  MCR,  the 
RSX-llM/M-PLUS  command  languages.  Sentences  in  these  two  grammars  are 
called  commands.  Here  is  a  metalanguage  definition  for  the  grammar  of 
the  DCL  ASSIGN  command: 

assign  ::*  ASSIGN  [  /  <qual>  1  <device>  <device> 

qual  :-.'    LOCAL  |  LOGIN  |  GLOBAL  |  TERMINAL:   <device> 

Here  is  a  metalanguage  definition  for  the  grammar  of  the  MCR  ASN 
command : 

asn  ::=  ASN  <device>=<devlce>  (  /  <qual>  1 

qual  ::=  LOGIN  |  GBL  I  TERM-  <devlce> 

The  following  section  describes  the   Macro   Metalanguage   (MML) .  MML 

implements   the   logic   of   the   metalanguage   above.   MML  defines  the 

grammars  for  the  DCL  and  MCR   command   languages.    Additionally,  MML 

expresses  the  mapping  from  DCL  grammar  to  semantically  equivalent  MCR 
grammar.   MML  provides  a  more  efficient  means  of  generating  (by  means 

of  the  MACRO-11  assembler)  the  data  structures  that  drive  the 
parser/translator  process  than  the  metalanguage  notation. 


12.6   THE  MACRO  METALANGUAGE 

The  Macro  MetaLanguage  (MML)  is  a  set  of  MACRO-11  macros  and  rules. 
The  following  describes  the  correspondence  of  the  metalanguage 
notation  presented  in  the  preceding  section  to  MML  notation. 

The  general  metalanguage  presented  In  the  preceding  section  supports 
two  logical  operators: 

implied-AND  and  exclusive-OR 

The  Macro  MetaLanguage  has  two  MACRO-11  macros  to  correspond  to  these 
logical  operators: 

AND  and  OR  macros 

The  general  metalanguage  presented  in  the  previous  section  supports 
two  types  of  syntax  elements: 

literals  and  nonllterals 

In  MML,  literals  and  nonllterals  are  presented  as  arguments  to  the  AND 
and  the  OR  macros. 
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In  MML,  literals  are  distinguished  from  nonliterals  by  making  the 
first  character  a  quote  character  (for  example,  'ASSIGN).  An  optional 
argument  that  you  can  specify  with  a  literal  is  the  abbreviation 
count.  The  abbreviation  count  is  a  numeral  that  indicates  the  minimum 
number  of  characters  that  the  parser  needs  to  match  for  a  successful 
parse.   For  example  you  could  rewrite 

•ASSIGN  --  to  —  <'ASSIGN,4> 

to  indicate  that  the  literal  "ASSIGN"  can  be  abbreviated  to  "ASSI". 

NOTE 

The  use  of  the  symbols  "<"  and  ">" 
indicates  (to  MACRO-11)  that  the 
argument  "'ASSIGN, 4"  is  one  argument 
(not  two:  ASSIGN  and  4).  Do  not 
confupe  these  symbols  with  the  identical 
metalanguage  symbols  used  to  identify 
nonl i terals. 

In  the  general  metalanguage  presented  in  the  previous  section,  a 
nonliteral  is  a  reference  to  a  category.  You  define  a  category  with 
the  "::■"  symbol  by  specifying  the  name  of  the  category  to  the  left  of 
the  symbol  and  the  definition  for  the  category  to  the  right  of  the 
symbol . 

In  MML,  you  define  a  category  by  placing  a  MACRO-11  label  on  either 
the  AND  or  the  OR  macro.  The  leibel  is  the  name  of  the  category,  and 
the  arguments  to  the  macro  are  the  definition  for  the  category.  Thus, 
in  MML,  a  nonliteral  is  the  label  (of  an  AND  or  OR  macro)  that  you  use 
as  an  argument  to  an  AND  or  OR  macro. 

For  example,  the  metalanguage  notation  for  the  category  <qual>  is: 

qual  ::•  GLOBAL  |  LOCAL  I  TERMINAL:   <device> 
The  equivalent  MML  notation  is: 

QUAL:   OR  'GLOBAL  'LOCAL  TERM 

TERM:   AND  'TERMINAL:   $DEV 

There  are  two  categories  —  QUAL  and  TERM.  There  are  three  category 
definitions  for  QUAL:  'GLOBAL,  'LOCAL,  or  TERM.  'GLOBAL  and  'LOCAL 
are  literals  and  TERM  is  a  nonliteral.  The  category  definition 
•TERMINAL:  $DEV  —  defines  the  category  TERM,  which  consists  of  a 
literal  'TERMINAL  and  a  predefined  nonliteral,  $DEV.  (See  Section 
12.11  for  a  description  of  $DEV) . 


Note  that  you  must  express  a  category  definition  like  •TERMINAL:  $DEV 
on  a  separate  line  (using  the  AND  macro)  because  an  argument  to  either 
the  AND  or  the  OR  macro  can  only  represent  one  syntax 
element  —  either  a  literal  or  a  nonliteral. 


Use  the  MML  notation  "OPT-T"  (optional-true)  to  indicate  that  syntax 
elements  are  optional.  This  notation  corresponds  to  the  metalanguage 
notation  "("  and  "1".  The  optional  syn'iax  notation  "OPT»T"  is  an 
attribute  of  syntax  elements  (literals  and  nonliterals).  You 
represent  literals  and  nonliterals  in  MML  notation  as  arguments  to  AND 
and  OR  macros.  Therefore,  you  specify  the  optional  syntax  indicator 
"OPT«T"  as  part  of  the  arguments. 
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To  specify  "OPT-T"  as  an  attribute  of  a  syntax  element,  enclose  the 
syntex  element  and  the  "OPT-T"  notation  in  angle  brackets.  For 
example,  to  specify  that  the  terminal  device  specification  ($DEV)  In 
the  previous  example  is  an  optional  syntax  ele  ent  (nonl iteral ) , 
rewrite  the  category  TERM  as  follows: 

TERM:   AND  'TERMINAL:   <$DEV  OPT»=T> 

Use  the  "OPTR-T"  attribute  to  indicate  that  a  syntax  element  Is 
optional  and  to  indicate  that  the  parser 'translator  can  process  the 
syntax  element  repeatedly. 

The  notation  OPT  means  a  syntax  element  can  occur,  at  most,  one  time. 
The  notation  OPTR  means  a  syntax  element  can  occur  many  times.  In 
either  case,  the  element  can  occur  zero  times. 

For  a  complete  description,  see  Section  12.10. 

To  specify  an  arbitrary  number  of  arguments  for  the  AND  and  OR  macros, 
use  the  OR.,  AND.,  and  the  END  macros.  Use  the  AND.  and  OR.  macros 
as  continuation  markers  for  the  AND  and  OR  macros  respectively.  That 
Is,  If  there  is  not  enough  space  on  the  line  for  all  the  arguments  to 
either  the  AWD  or  OR  macros,  place  additional  arguments  on  the  next 
line.  To  do  this,  place  the  AND.  or  the  OR.  macro  on  the  next  line 
followed  by  the  continuation  of  the  specification  of  the  arguments. 
For  example,  you  could  rewrite  the  category  for  <qual>  to: 

QUAL:    OR  'GLOBAL  'LOCAL 
OR,  TERM 
END 

Use  the  END  macro  to  Indicate  the  end  of  the  specification  of  the 
arguments.  Note,  to  allow  this  continuation  abllHy  (without  any 
additional  overhead),  you  need  the  END  macro  whether  or  not  you  use 
the  continuation  ability.  For  example,  you  would  need  the  END  macro 
In  the  following  category  for  <qual>: 

QUAL:    OR  'GLOBAL  'LOCAL  TERM 
END 

Thus,  you  can  use  MML  like  the  metalanguage  of  the  general  description 
In  Section  12.5  to  define  the  syntax  of  a  DCL  command  and  the  syntax 
of  the  corresponding  MCR  command.  The  parser  table  (PT)  defines  the 
syntax  of  the  DCL  command  and  the  translator  table  (TT)  defines  the 
syntax  of  the  corresponding  MCR  command.  The  following  section 
describes  how  the  PT  and  TT  drive  the  parser/translator  process  (or 
hovv  the  parser  and  the  translator  Interpret  the  PT  and  the  TT)  . 


12.7   INTERPRETING  DCI.  COMMAND  TABLES 

A  parser  table  (PT)  and  translator  table  (TT)  drive  the 
parser/translator  process,  There  Is  a  PT/TT  for  each  DCL  command. 
The  PT  defines  the  DCL  syntax  and  the  TT  defines  the  corresponding  MCR 
syntax.  The  parser/translator  process  locates  the  PT  and  the  TT  for  a 
particular  DCL  command  line  by  searching  the  master  command  table 
(MCT)  for  the  command  entry.  The  parser/translator  extracts  from  the 
command  entry  the  address  of  the  first  AND  or  OR  macro  of  the  PT  and 
the  address  of  the  first  AND  or  OR  macro  of  the  TT. 
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The  parser  starts  processing  at  the  address  of  the  first  macro  in  the 
PT.  If  the  processing  of  this  macro  succeeds,  then  the  parser  process 
succeeds.  A  successful  parser  process  means  that,  at  this  point,  the 
input  command  line  is  a  syntactically  correct  DCL  command  line  (as 
defined  by  the  PT)  and  the  Intermediate  form  (IPORM)  has  been 
constructed.  The  IPORM  Is  a  condensed  representation  of  the  input 
command  line.  If  the  processing  of  this  macro  fails,  then  the  parser 
process  fails. 

The  parser  processes  the  AND  macro  by  processing  (left-to-right)  each 
argument  (syntax  element)  of  the  AND  macro  until  either  all  arguments 
process  successfully  or  an  argument  is  encountered  that  does  not 
process  successfully.  If  all  arguments  process  successfully,  then  the 
processing  of  the  AND  macro  succeeds;  otherwise,  the  processing  of 
the  AND  macro  fails. 

The  parser  processes  the  OR  macro  by  processing  (left-to-right)  each 
argument  (syntax  element)  of  the  OR  macro  unti'  either  the  parser 
successfully  processes  one  syntax  element  or  the  parser  fails  to 
process  any  of  the  syntax  elements.  If  the  parser  successfully 
processes  one  syntax  element,  then  the  processing  of  the  OR  macro 
succeeds;   otherwise,  the  processing  of  the  OR  macro  fails. 

The  translator  starts  processing  at  the  address  of  the  first  macro  of 
the  TT.  If  the  processing  of  this  macro  succeeds,  then  the 
translation  succeeds  and  an  equivalent  MCR  command  line  (as  defined  by 
the  TT)  has  been  constructed  from  the  IPORM.  If  the  processing  of 
this  macro  fails,  then  the  translator  process  fails.  The  processing 
of  the  AND  and  OR  macros  by  the  translator  is  the  same  as  the 
processing  of  the  AND  and  OR  macros  by  the  parser  (as  described  in  the 
previous  section). 

Arguments  to  AND  and   OR  macros   can   be  literals   or   nonliterals. 

Nonliterals   are   handled   in   the  same  way  by  both  the  parser  and  the 

translator.  Literals,  however,  are  handled  differently  by  the  parser 
and  the  translator. 

Here  is  a  description  of  how  nonliterals  are  handled  by  both  the 
parser  and  the  translator. 

In  MML,  when  you  use  the  label  of  an  AND  or  OR  macro  as  the  argument 
to  an  AND  or  OR  macro  it  is  called  a  nonliteral;  thus,  a  nonliteral 
is  the  address  of  another  AND  or  OR  macro.  The  processing  of  a 
nonliteral  is  the  processing  of  the  other  AND  or  OR  macro  that  the 
nonliteral  addresses.  That  is,  when  the  parser  or  translator 
encounters  a  nonliteral  (as  an  argument  to  an  AND  or  OR  macro),  the 
parser  or  translator  transfers  parsing  or  translation  control  to  the 
macro  that  the  nonliteral  addresses.  The  addressed  macro  is  either  an 
AND  or  OR  macro  and  the  parser/translator  processes  this  macro  like 
all  AND  or  OR  macros  (as  described  in  the  previous  section).  If  the 
processing  of  this  macro  succeeds,  then  the  processing  of  the 
nonliteral  succeeds;  otherwise  the  processing  of  the  nonliteral 
fails. 

H«r«  is  a  description  of  the  different  handling  of  literals  by  the 
parser  and  the  translator. 

A  string  of  ASCII  characters  used  as  an  argument  to  an  AND  or  OR  macro 
is  called  a  literal.  The  string  typically  is  a  keyword  in  the  DCL  or 
MCR  command  grammar.  The  parser  and  translator  process  literals 
differently. 
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In  parsing  a  literal,  the  parser  attempts  to  match  the  literal  to  the 
input  DCL  command  line.  If  the  input  command  line  contains  the  same 
ASCII  string  as  the  literal,  then  the  match  is  successful  and  the 
processing  of  the  literal  succeeds;   otherwise,  nothing  happens. 

However,  in  translating  a  literal,  the  translator  copies  the  literal 
fiom  the  TT  to  the  MCR  command  line  buffer.  If  you  do  not  associate 
attributes  with  a  literal  in  a  TT,  then  the  processing  of  the  literal 
always  succeeds.  ^Writing  a  literal  to  the  MCR  command  line  buffer 
always  succeeds.)  A  literal  in  a  TT  can  fail  only  if  you  have 
associated  one  of  the  following  attributes  with  the  literal: 

MAP,  CBM,  BCT,  BST 

With  tliese  attributes  associated  with  a  literal,  the  translator 
processes  the  attributes  before  the  literal  is  written  to  the  MCR 
command  line  buffer. 

The  MAP  attribute  instructa  the  t-anslator  to  check  for  a  mapping 
number  in  the  IFORM.  If  the  number  is  not  there,  the  translator  does 
not  write  the  literal  to  the  MCR  command  line  buffer  and  the 
processing  of  the  literal  fails. 

The  CBM,  BCT,  and  BST  attributes  instruct  the  translator  to  check  the 
status  of  certain  bits  in  its  internal  data  structures.  If  th'»  status 
of  the  bits  is  not  correct,  the  translator  does  not  write  t  h*"  literal 
to  the  MCR  command  line  buffer  and  the  processing  of  the  'iteral 
fails.   See  Section  12.10  for  more  information  on  these  attributes). 

In  summary,  the  parser  table  (PT)  drives  the  parser  and  the  translator 
table  (TT)  drives  the  translator.  The  parser/translator  succeeds  only 
if  the  processing  of  the  first  AND  or  OR  macro  of  the  PT/TT  succeeds. 
The  processing  of  an  AND  or  OR  macro  succeeds  only  when  the  processing 
of  the  arguments  to  the  macros  succeed.  Arguments  can  be  either 
literals  or  nonliterals.  A  nonliteral  instructs  the  parser/translator 
to  process  (recursively)  another  AND  or  OR  macro  and  succeeds  only  if 
the  subsequent  AND  or  OR  macro  succeeds.  A  literal  instructs  the 
parser  to  ensure  the  input  command  line  matches  the  literal  and 
succeeds  only  if  the  match  is  successful.  A  literal  instructs  the 
translator  to  output  the  literal  (possibly  conditionally)  to  the  MCR 
command  line  and  the  translator  succeeds  only  if  either  the  literal  is 
not  conditional ized  or  the  conditionals  are  satisfied. 

The  following  is  an  example  of  a  parser  table  (PT)  for  the  DCL  ASSIGN 
command. 

MML  NOTATION  for  PARSER  TABLE 


ASSIGN: : 

AND 

END 

'ASSIGN  <QU 

QUAL: 

AND 
END 

V  QUALI 

QUALI: 

OR 

<'L0CAL,4> 

OR. 

<'L0GIN,4> 

OR. 

<'GL0BAL,2> 

OR. 

TERM 

END 

TERM: 

AND 

END 

'TERMINAL: 

<'TERMINAL,4>' 
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The  following  is  an  example  of  a  translator  table  (TT)  for  the  NCR  ASN 
command. 


MML  NOTATION  for  TRANSLATOR  TABLE 


ASN;:    AND 

END 
LAUQ:    OR 

OR. 

OR. 

END 
NRET:    AND 

END 


> 


'ASN  $DEV  •-  $DEV  <LAUQ  OPTR-T> 

•/LOGIN 

VGBL 

MRET 

'/TERM-  $DEV 


These  examples  show  the  first  two  steps  you  must  follow  in  creating 
the  tables  for  the  DCL  ASSIGN  command.  The  last  step  is  to  express 
the  mapping  of  the  syntax  elements  in  the  PT  to  the  syntax  elements  in 
the  TT.  This  mapping  provides  the  information  that  the 
parser/translator  process  needs  to  construct  a  particular  MCR  ASN 
command  line  given  a  particular  DCL  ASSIGN  command  line.  The 
following  section  describes  how  to  express  this  mapping. 


12.8   MAPPING  DCL  TO  NCR 

The  mapping  of  a  given  DCL  command  line  to  the  equivalent  MCR  command 
line  is  accomplished  in  the  IFORM.  The  parser  processes  mapping 
information  and  records  it  in  the  IFORM.  The  translator  searches  the 
IFORM  for  mapping  information  and  then  generates  the  MCR  command  line. 

Mapping  information  is  expressed  in  MML  with  the  "MAP-n"  attribute. 
MAP  takes  one  or  two  values.  The  first  value  is  called  the  primary 
mapping  number.  The  second  value  is  called  the  secondary  mapping 
number.  If  you  need  only  the  primary  mapping  number,  specify  it  in 
the  following  form: 

MAP-n 

If  you  need  to  specify  both  mapping  numbers,  which  is  allowed  only  in 
a  TT,  or  if  you  need  to  specify  only  the  second  number,  then  enclose 
the  numbers  in  angle  brackets  and  separate  them  with  a  comma  in  the 
following  form: 


MAP=<n,n>  or  MAP-<,n> 

To  associate  the  MAP  attribute  with   a   syntax   element,   enclose 
syntax  element  and  the  MAP  attribute  in  angle  brackets  as  follows: 


the 


<syn tax-element 


MAP=n> 


To  map  a  DCL  syntax  element  in  a  PT  to  an  MCR  syntax  element  in  the 
corresponding  TT,  use  MAP  with  the  same  mapping  number  for  both  syntax 
elements . 

For  example,  in  the  ASSIGN  command,  the  DCL  qualifier  "/GLOBAL"  maps 
to  the  MCR  qualifier  "/GBL".  That  is,  when  the  DCL  qualifier 
"/GLOBAL"  is  input  (as  part  of  the  DCL  command  line),  the  MCR  switch 
"/GBL"  is  output  (as  part  of  the  MCR  commeind  line)  . 


12-20 


THE  DCL  T%SK 

The  following  expresses  this  mapping  in  MML  notation  and  illustrates 
the  use  of  the  primary  MAP  number. 

QUAL:    OR  <* /GLOBAL  MAP-1>  ... 
END 

LAUQ:    OR  <'/GBL  MAP-1>  ... 
END 

MML  macros  at  QUAL:  define  DCL  syntax.  MML  macros  at  LAUQ:  (QUAL 
spelled  backwards)  define  the  corresponding  MCR  syntax.  When  the 
parser  reaches  QUAL:,  it  tries  to  match  the  literal  "/GLOBAL"  to  the 
input  (DCL)  command  line.  If  the  match  is  successful,  then  the  parser 
queues  the  MAP  number  "PI"  (the  "P"  indicates  a  primary  mapping 
number)  to  the  IFORM  queue.  When  the  translator  reaches  LAUQ:,  it 
searches  the  IFORM  queue  for  the  MAP  number  "PI".  If  the  translator 
finds  the  MAP  number  "PI",  it  outputs  to  the  (f'^rming)  MCR  command 
line  the  literal  "/GBL".  If  the  translator  cannot  find  the  MAP  number 
in  the  IFORM  queue,  it  does  not  use  the  syntax  element  (associated 
with  the  MAP  number)  in  the  translation. 

The  MAP  attribute  in  a  PT  can  associate  either  a  primary  or  a 
secondary  mapping  number  with  a  syntax  element,  but  not  both. 

The  MAP  attribute  in  a  TT  can  associate  either  or  both  mapping  numbers 
with  a  syntax  element. 

Associating  a  primary  mapping  number  with  a  syntax  element  in  the  PT 
(by  means  of  the  MAP  attribute)  instructs  the  parser  to  queue  the 
primary  mapping  number  to  the  IFORM  queue. 

Associating  a  secondary  mapping  number  with  a  syntax  element  in  the  PT 
instructs  the  parser  to  queue  the  secondary  mapping  number  to  the 
IFORM  queue. 

In  both  cases  the  parser  queues  a  mapping  number  only  if  the  parser 
processes  the  associated  syntax  element  successfully. 

The  MAP  attribute  in  a  TT  instructs  the  translator  to  search  the  IFORM 
queue  for  a  mapping  number.  When  found,  the  translator  marks  the 
mapping  number  used  and  processes  the  associated  syntax  element. 

The  search  for  a  primary  mapping  number  differs  from  the  search  for 
secondary  mapping  numbers.  The  translator  searches  the  entire  IFORM 
queue  from  head  to  tail  to  find  primary  mapping  numbers.  The 
translator  limits  its  search  for  secondary  mapping  numbers,  however. 
The  translator  starts  its  search  for  secondary  mapping  numbers  at  the 
queue  element  containing  the  last  used  primary  mapping  number  and 
stops  the  search  at  the  next  queue  element  containing  a  primary 
mapping  number. 

Specifying  both  a  primary  and  a  secondary  mapping  number  in  the  TT 
(for  example,  MAP=<1,1>)  instructs  the  translator  to  search  the  entire 
IFORM  queue  for  the  specified  primary  mapping  number  such  that  the 
specified  secondary  mapping  number  follows  without  any  intervening 
primary  mapping  numbers.  The  secondary  mapping  number  qualifies  the 
primary  mapping  number.  The  primary  mapping  number  is  the  object  of 
the  search. 
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If  the  translator  finds  a  mapping  number  in  the  IFORM  queue,  the 
translator  processes  the  associated  syntax  element.  If  the  translator 
fails  to  find  the  mapping  number,  the  processing  of  the  associated 
syntax  element  fails.  When  the  translator  finds  a  mapping  number  and 
successfully  processes  the  associated  syntax  element,  the  translator 
marks  as  used  the  queue  element  containing  the  found  mapping  number. 
A  used  mapping  number  can  no  longer  be  found-  This  prevents  infinite 
loops  in  the  TT  without  requiring  the  specification  of  termination 
conditions. 

A  MAP  attribute  can  be  specified  in  both  the  PT  and  the  TT  without 
associating  it  with  a  syntax  element  as  follows: 

<MAP-n> 

If  you  specify  this  attribute  as  an  argument  to  an  AND  or  OR  macro  in 
a  PT,  the  parser  assumes  a  null  syntax  element.  A  null  syntax  element 
always  succeeds. 

If  you  specify  a  nuxl  syntax  element  in  a  TT,  the  translator  (after 
finding  the  queue  element  containing  the  mapping  number)  checks  to  see 
if  a  character  buffer  is  attached  to  the  queue  element.  If  a 
character  buffer  is  attached,  then  the  translator  copies  the  contents 
of  the  buffer  to  the  NCR  command  line  buffer.  If  a  character  buffer 
is  not  attached,  then  the  translator  (like  the  parser)  assumes  a  null 
syntax  element  (which  always  succeeds) . 

The  parser  attaches  the  character  buffer  to  the  queue  element.  The 
COP  attribute  instructs  the  parser  to  create  the  character  buffer  and 
copy  the  text  parsed  by  the  associated  syntax  element  to  the  character 
buffer  (See  Section  12.10  for  details  on  the  COP  attribute). 

Thus,  mapping  starts  in  the  parser  process  when  the  parser  queues 
mapping  numbers  to  the  IFORM  queue  as  it  successfully  processes  syntax 
elements  that  have  associated  MAP  attributes. 

Mapping  is  completed  in  the  translator  process,  when  the  translator 
detects  mapping  numbers  in  the  IFORM  queue  and  translates  the  syntax 
elements.  Note  that  the  translator  does  not  output  a  syntax  element 
that  has  a  MAP  attribute  associated  with  it  unless  (1)  the  translator 
first  finds  the  mapping  number  in  the  /FORM  queue,  and  (2)  the  mapping 
number  has  not  been  previously  used. 

Here  is  an  example  of  a  complete  command  table  (with  DCL-MCR  mapping) 
for  the  DCL  ASSIGN  command. 

ASSIGN  MML  NOTATION  FOR  PARSER  TABLE 

'ASSIGN  <QUAL  OPTR-T>  <$DEV  MAP-1>  <$DEV  MAP"2> 

'/  QUALI 

<'L0CAL,3> 
<'L0GIN,3   MAP-3> 
< 'GLOBAL, 2   MAP-4> 
TERM 

<'TERMINAL,4>'    <DEV   MAP-5> 


ASSIGN: : 

AND 

END 

QUAL: 

AND 

END 

QUALI : 

OR 

OR. 

OR. 

OR. 

END 

TERM: 

AND 

END 
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ASN:  : 

AND 

END 

LAUQ: 

OR 

OR. 

OR. 

END 

MRET: 

AND 

END 
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ASN  MML  NOTATION  FOR  TRANSLATOR  TABLE 

•ASN  <MAP-1>  •-  <MAP-2>  <LAUO  OPTR-T> 

<• /LOGIN  MAP-3> 
<'/GBL  MAP-4> 
MRET 

'/TERM-  <MAP-5> 

For  a  complete  description  of  the  MAP  attribute,  see  Section  12.10. 
For  information  on  related  attributes  see  the  discussions  of: 

DMAP,  NO,  COP,  OCOP,  TST,  and  DIR 

The  parser  records  mapping  information;  the  translator  detects  the 
mapping  information.  The  following  section  presents  IFORM,  the 
dynamic  data  structure  that  passes  mapping  information  from  the  parser 
to  the  translator. 


12.9   THE  INTERMEDIATE  FORM  (IFORM) 

The  IFORM  contains  the  essential  information  (extracted  from  the  input 
DCL  command  line)  that  the  translator  needs  to  construct  the  MCR 
command  line.  The  IFORM  consists  of  three  data  structures:  the 
queue,  the  character  buffers,  and  the  general  bit-mask  words. 

NOTE 

To  display  the  IFORM   for   a   given   DCL 
command,  use  SET  DEBUG/FULL. 

The  parser  creates  the  IFORM  queue  when  it  successfully  processes 
syntax  elements  with  MAP  attributes.  Each  time  the  parser 
successfully  processes  a  MAP  attribute,  it  queues  the  mapping  number 
to  the  IFORM  queue. 

The  parser  creates  a  character  buffer  when  a  syntax  element  has  both 
MAP  and  COP  attributes.  The  parser  attaches  the  character  buffer  to 
the  queue  entry  that  contains  the  mapping  number.  The  character 
buffer  contains  the  text  parsed  during  the  processing  of  the 
associated  syntax  element. 

A  syntax  element  with  a  COP  attribute  and  no  MAP  attribute  instructs 
the  parser  to  copy  the  text  parsed  to  the  last  queued  mapping  number 
(creating  and  attaching  the  character  buffer  if  neccessary) . 

The  general  bit-mask  words  are  two  words  used  as  a  set  of  32  flags. 
The  parser/translator  process  attaches  no  meaning  to  the  flags,  but 
MML  provides  a  set  of  attributes  to  set  flags,  clear  them,  test  if  the 
flags  are  set,  and  test  if  the  flags  are  clear.  You  can  use  the  flags 
to  check  for  contradictory  syntax.  In  addition,  use  the  flags  to  pass 
information  from  the  parser  to  the  translator.  For  example,  set  a 
flag  during  the  parser  process  if  a  DCL  qualifier  is  seen  and  detect 
the  set  flag  during  the  translator  process,  generating  the  equivalent 
MCR  switch. 
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Th^  translator  searches  the  IFORM  queue  for  mapping  numbers.  If  the 
translator  finds  the  mapping  numbers,  it  processes  the  syntax 
elements.  If  the  translator  cannot  find  the  mapping  numbers,  then  the 
syntax  elements  fail. 

If  a  NAP  attribute  is  specified  without  an  associated  syntax  element 
as  follows: 

<MAP-n^ 

the  translator  first  finds  the  queue  element  containing  the  mapping 
number  and  then  examines  the  queue  element  for  a  character  buffer 
attached  by  means  of  the  COP  attribute.  If  the  translator  finds  an 
attached  character  buffer,  it  copies  the  contents  of  the  buffer  to  the 
NCR  command  line  buffer.  If  the  translator  cannot  find  an  attached 
buffer,  it  assumes  a  null  syntax  element  (which  always  succeeds). 

Use  the  following  attributes  (in  the  PT)  to  direct  the  parser  in  the 
creation  of  the  IFORM: 


MAP-n  MAP-<,n> 

DMAP-n  DMAP-<,n> 

COP-T  OCOP-T 

BS«n  BS"<,n>  BS-<n,n> 

BC-n  BC-<,n>  BC»<n,n> 

NO-T 


(map) 

(map  unless  duplicate  exists) 

(copy,  or  copy  optional  input) 

(set  bit  in  mask  word) 

(clear  bit  in  mask  word) 

(repeats   for   negative   form 
syntax  element) 


of 


Use  the  following  attributes  (in  the  TT)  to  direct  the   translator   in 
the  examination  of  the  IFORM: 


MAP-n 
BST^n 
BCT-n 
TST-T 

DIR-T 


MAP»<,n>  MAP«<n,n> 
BST"<,n>  BST»<n,n> 
BCT'<,n>  BCT-<n,n> 


(unmap) 

(test  for  bit  set  in  mask  word) 

(test  Lcr  bit  clear  in  mask  word) 

(test  for  mapping   number,   do   not 
mark  as  used) 

(search  IFORM  in  reverse  direction) 


For  details  on  these  attributes,  see  Section  12.10. 
For  example,  if  the  input  command  line  is: 

ASSIGN  DKl:   SY: 
then  the  IFORM  would  bo: 

Queu*         Character  Buffer 


PI 


DKl: 


P2 


SYi 


• 
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If  the  input  command  line  is: 

ASSIGN/L0GIN/T:TT12!   DKl:   SYs 

then  the  IPORM  would  be: 

Queue  Character  Buffer 


P3 


P5 


PI 


P2 


TT12: 

DKl: 

SY: 

12.10   ATTRIBUTES  OF  SYNTAX  ELEMENTS 

Attributes  associate  characteristics  with  literal  and  nonliteral 
syntax  elements.  The  parser/translator  processes  attributes  either 
before  or  after  it  processes  the  associated  syntax  elements  (depending 
on  the  attribute).  The  processing  of  attributes  can  influence  the 
processing  of  the  associated  syntax  elements. 

Here  is  the  format  for  specifying  attributes  as  part  of  an  argument  to 
an  AND  or  OR  macro: 

<'literal   KEY=value  KEYl-value  ...> 


where 


or 

<label 

literal 
label 
KEY 
value 


KEY=value  KEYl=value  ...> 

Literal  (ASCII)  string 

Nonliteral  (address  of  an  AND  or  OR  macro) 
Attribute  keyword  identifying  the  attribute 
Value  assigned  to  the  attribute 


Note  the  use  of  the  angle  brackets  "<"  and  ">".  Use  these  MACRO-11 
symbols  to  indicate  that  everything  enclosed  is  considered  as  one 
argument  (when  expanding  macros).  Do  not  confuse  these  MACRO-11  angle 
brackets  with  the  angle  brackets  used  to  indicate  nonliterals  in 
metalanguage  notation. 


12.10.1  AND 

AND  allows  you  to  extend  a  syntax  element  by  specifying  a  nonliteral 
that  is  ANDed  to  the  syntax  element.  The  primary  function  of  AND  is 
to  allow  OR  logic  to  be  mixed  with  AND  logic.  Assign  a  nonliteral  to 
the  AND  attribute  as  follows: 


AND= label 


where 


label   Nonliteral  address  of  an  AND  or  OR  macro 
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AND  instructs  the  parser/translator  to  process  the  AND  or  OR  macro 
that  the  label  (the  nonllteral)  addresses  in  addition  to  processing 
the  syntax  element  with  which  the  AND  attribute  is  associated. 

For  example,  in  the  following  MML  definition  for  QUAL,  the  second 
syntax  element  defines  the  structure  "FILE: <f ilespec>" ; 

QUAL:    OR  'BRIEF 

OR.  <'FILE  AND-FNAME> 

OR.  'FULL 

END 

FNAME:   AND      ':  $FILE 
END 

There  are  three  syntax  elements  in  this  structure: 

FILE 

anrt 


and 

<f  i  lespeO 

The  literal  ":"  and  the  nonliteral  <filespec>  connect  to  the  literal 
"FILE"  by  means  of  the  AND  attribute.  The  parser/translator  processes 
all  three  elements  as  one  element  to  the  OR  macro  by  definition  of  the 
AND  attribute. 


12.10.2   BC  and  BS 

BC  (Bit  Clear)  and  BS  (Bit  Set)  operate  on  two  global  bit-mask  words. 

The  BC  attribute  instructs  the   parser/translator   to   clear   bits   in 
these  two  global  words. 

The  BS  attribute  instructs  the  parser/translator  to  set  bits  in   these 
two  global  words. 

Use  the  BCT  and  BST  attributes  to  test  these  bits.   See  next  section. 

The  format  for  these  attribute'^,  is  as  follows: 

BC»n  or      BC"<,nl>        or  BC»<n,nl> 

BS"n  or      BS»<,nl>        or  BS«<n,nl> 

where 

n  Bit  mask  specifying  bits  in  the  first  global  word 

nl  Bit  mask  specifying  bits  in  the  second  global  word 


Specify  a  bit   mask   by  ORing   single   bit   specifications   with   the 

MACRO-11   symbol   "!".  The   symbols   Bl,  B2,...B32  are  predefined  to 

correspond  to  single  bit  specifications  for  each  bit  in  the  two  global 
words. 
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For  example,  BS-B1IB2IB5  means  to  set  bits  1,  2,  and  5  of  the  first 
global  word.  See  the  next  section  for  an  example  of  these  attributes 
in  use. 


12.10.3   BCT  and  BST 

BCT  (Bit  Clear  Test)  and  BST  (Bit  Set  Test)  test  the  status  of  bits  In 
the  two  global  bit-mask  words.  See  the  previous  section  for 
information  on  how  these  bits  are  set  or  cleared. 

The  BCT  attribute  instructs  the  parser/translator  to  test  whether  bits 
are  cleared. 

The  BST  attribute  instructs  the  parser/translator  to  test  whether  bits 
are  set. 

The  parser/translator  does  not  clear  the  two  global  bit-mask  words 
between  the  parse  and  the  translation.  You  can  use  these  words  as 
part  of  the  IFORM  to  pass  information  from  a  PT  to  a  TT. 

The  format  for  these  attributes  is  as  follows: 

BCT-n    or       BCT-<,nl>        or       BCT-<n,nl> 
BST=n    or       BST»<,nl>        or       BST»<n,nl> 

where 

n       Bit  mask  specifying  bits  in  the  first  global  word 

nl      Bit  mask  specifying  bits  in  the  second  global  word 

For  example,  BST=< ,B19!B31>  means  to  test  whether  bits  19  and  31  of 
the  second  global  bit-mask  word  are  set. 

The  following  example  illustrates  the  use  of  BS,  BC,  BST,  and  BCT: 

COPY:    AND      FILE  <FILE  OPTR«T>  QUA=QUAL 
END 

FILE:    OR       <$NFIL  BS-Bl    BCT-B2!B3> 

OR.      $FILE 
END 

QUAL:    OR       <• INDEX  BS=B2    BCT-Bl!B3> 

OR.       <'SEOUENTIAL     BS«B3    BCT=«Bl!B2> 
END 

In  this  example,  INDEX  and  SEQUENTIAL  are  qualifiers,  $NFIL  is  a 
predefined  syntax  element  that  is  a  file  specification  that  has  a  node 
name  prefixing  it,  and  $FILE  is  a  predefined  syntax  element  that  is  a 
conventional  file  specification  (without  a  node  name).  The  example 
specifies  that  the  qualifiers  INDEX  and  SEQUENTIAL  are  contradictory, 
that  INDEX  and  $NFIL  are  contradictory,  that  SEQUENTIAL  and  $NFIL  are 
contradictory,  but  that  duplicates  of  each  are  not  contradictory.  The 
BS  attribute  instructs  the  parser  to  set  the  specified  bits  if  the 
processing  of  the  associated  syntax  elements  is  successful.  The  BCT 
instructs  the  parser  to  test  whether  the  specified  bits  are  clear. 
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If  tt.e  tested  bits  are  set,  the  parser  does  not  process  the  associated 
syntax  elements.  Thus,  bits  are  set  to  remember  which  syntax  elements 
process  successfully,  and  bits  are  tested  to  determine  if  a 
contradiction  would  result  from  the  processing  of  syntax  elements. 

The  main  difference  between  the  BC,  BCT,  BS,  and  BST  attributes  and 
CBN  (described  in  the  next  section)  is  that  CBM  always  prevents 
duplicate  syntax  as  well  as  contradictory  syntax,  but  CBM  cannot  pass 
information  from  the  parser  to  the  translator. 


12.10.4   CBM,  CCBM 

Use  CBM  (Contradictory  Bit  Mask)  to  prevent  the  parser  or  translator 
from  allowing  contradictory  syntax.  To  indicate  that  two  or  more 
syntax  elements  cannot  be  specified  in  the  same  command  line,  specify 
CBM  with  each  syntax  element.  Assign  a  bit  mask  as  the  value  to  CBM. 
Specify  the  same  bit  in  eac.  bit  mask  associated  with  each 
contradictory  syntax  element. 

CBM  conditional izes  the  processing  of  the  associated  syntax  element. 
The  parser  uses  the  specified  bit  mask  to  set  bits  in  two  global 
words.  If  the  parser  detects  that  any  bits  specified  in  the  bit  mask 
are  already  set  in  the  two  global  words,  then  the  parser  assumes  a 
contradiction  and  the  syntax  element  fails.  This  aljo  means  CBM  does 
not  allows  duplicate  syntax  elements. 

Also  note  that  the  parser/translator  clears  the  two  global  words 
between  the  parse  and  the  translation.  You  cannot  use  CBM  to  pass 
information  from  a  PT  to  a  TT. 

The  format  of  the  CBM  attribute  is  as  follows: 
CBM=n  or  CBM=<,nl>  or  CBM»<n,nl> 

where 

n    Bit  mask  specifying  bits  in  the  first  global  word 

nl   Bit  mask  specifying  bits  in  the  second  global  word 

Specify  a  bit  mask  by  ORing  single  bit  specifications  with  the 
MACRO-11  symbol  "!".  The  symbols  Bl,  B2,...,  B32  are  predefined  to 
correspond  to  single  bit  specification.  For  example,  CBM>BliB2!BS 
specifies  bits  1,  2,  and  5  of  the  first  global  word,  and 
CBM«<,B19!B31>  specifies  bits  19  and  31  of  the  second  global  word. 

The  following  example  illustrates  the  use  of  the  CBM  attribute: 

QUAL: 


OR 

<• LOCAL 

CBM»B1!B2> 

OR. 

<• LOGIN 

CBM»B2> 

OR. 

< 'GLOBAL 

CBM«B1> 

END 

The  example  specifies  that  the  literals  "LOCAL"  and  "GLOBAL"  are 
contradictory,  and  that  the  literals  "LOCAL"  and  "LOGIN"  are  also 
contradictory,  but  that  the  literals  "LOGIN"  and  "GLOBAL"  are  not. 
The  example  also  specifies  that  each  of  these  elements  can  be  used 
only  once. 
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CCBM  (Clear  Contradictory  Bit  Mask)  clears  the  bits  in  the  two  global 
words.  The  format  for  specifying  CCBM  Is  Identical  to  the  format  that 
you  use  to  specify  the  CBM  attribute. 


12.10.5  COP,  OCOP 

COP  (COPy)  Is  legal  only  In  a  PT  and  only  with  a  literal  syntax 
element.  COP  passes  a  literal  from  the  input  DCL  command  line  to  the 
IFORM.  The  translator  can  then  use  the  literal  In  the  MCR  command 
line.  The  parser  copies  the  literal  to  a  character  buffer  and 
attaches  It  to  the  mapping  number  last  queued.  If  you  specify  a  MAP 
attribute  with  the  COP  attribute,  the  mapping  number  (assigned  to  the 
MAP  attribute)  Is  the  mapping  number  last  queued. 

The  format  of  the  COP  attribute  Is  as  follows: 

COP-T 

For  example,  the  following  code  defines  a  terminal  specification: 

TERM:    OR  <'TT  COP-T  AND-N> 

OR.  <'HT  COP-T  AND»N> 

OR.  <'VT  COP=T  AND«N> 

OR.  <«TI  COP-T  AND-N> 

END 
Nt       AND  <$ONUM,0,3>  <*:  OCOP*T> 

This  code  parses  and  copies  a  terminal  name  as  TT,  VT,  HT,  or  TI 
followed  by  an  octal  number  as  terminal  names.  (See  Section  12.11.1 
for  a  description  of  SONUM,  which  defines  an  octal  number.)  The  OCOP 
attribute  assures  the  presence  of  the  terminating  colon  by  copying  it 
Into  a  character  buffer  whether  or  not  the  user  Inputs  one. 

To  Instruct  the  translator  to  copy  the  character  buffer  to  the  MCR 
command  line,  specify  the  MAP  attribute  as  follows,  without  specifying 
an  associated  syntax  element: 

<MAP-n> 

When  the  translator  processes  a  MAP  attribute  that  has  no  associated 
syntax  element,  the  translator  examines  the  mapping  number  queue 
element  for  an  attached  character  buffer.  If  a  character  buffer  Is 
found,  the  translator  copies  the  contents  of  the  character  buffer  to 
the  forming  MCR  command  line  buffer.  If  a  character  buffer  is  not 
found,  the  translator  assumes  a  null  syntax  element  (which  always 
processes  successfully). 

OCOP  (Optional  COPy)  is  identical  to  COP  except  for  one  significant 
difference.  OCOP  instructs  the  parser  to  copy  the  literal  to  the 
IFORM  whether  or  not  the  processing  of  the  literal  succeeds.  That  is, 
the  literal  Is  optional  and  always  succeeds  if  you  associate  OCOP  with 
It. 

The  following  Illustrates  the  use  of  the  OCOP  attribute: 

DEV:     AND      <$ALF,2,2>  <$NUM,0,3>  <':   OCOP-T> 

The  MML  definition  defines  a  device  specification  such  that  the  colon 
on  the  end  of  the  specification  is  optional.  The  translator  copies 
the  colon  to  the  output  MCR  command  line  whether  or  not  the  parser 
found  a  colon  in  the  input  DCL  command  line. 
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12.10.6   DIR 

DIR  (DIRectlon)  is  legal  only  in  the  TT  and  only  when  you  specify  it 
with  a  MAP  attribute.  DIR  instructs  the  translator  to  search  the 
IFORM  queue  for  the  specified  mapping  number  in  reverse  order.  The 
normal  direction  of  the  search  is  from  the  head  of  the  queue  to  the 
tail  of  the  queue.  DIR  instructs  the  translator  to  search  the  IFORM 
queue  from  the  tail  to  the  head  of  the  IFORM  queue.  The  format  for 
DIR  is  as  follows: 

DIR-R 

The  following  example  of  a  TT  fragment  illustrates  the  use  of  the  DIR 
attribute: 


FILE:    AND      <MAP-1  DIR-R  <MORE  OPT-T> 
END 

MORE:    AND      <<•  ,>>  FILE 
END 


This  example  (recursively)  defines  the  structure  of  a  file 
specification  list,  where  the  file  specifications  are  mapped  to 
mapping  number  1.  Due  to  the  associated  DIR  attribute,  the  translator 
searches  for  the  mapping  numbers  in  reverse  order;  thus,  the  list  of 
file  specifications  is  output  to  the  MCR  command  line  in  reverse 
order. 

NOTE 

The  double  angle  brackets  are  necessary 
in  cases  where  the  contents  of  the 
brackets  include  a  MACRO-11  separator 
character  (in  this  case,  the  comma)  that 
is  to  be  treated  as  a  literal  by  MML. 


12.10.7   ERR 

ERR  (ERRor)  allows  you  to  associate  error  messages  with  syntax 
elements.  If  the  parser  or  the  translator  fails  to  process  a  syntax 
element,  and  the  syntax  element  has  ERR  specified,  then  the  parser  or 
translator  prints  the  error  message  specified  and  aborts  the  parse  or 
translation. 

The  format  for  ERR  is  as  follows: 

ERR-'strlng 

or 

ERR-label 

label:   ERROR  </string/> 


• 
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for  example,  to  specify  an  error  message  for  the  device  being 
assigned,  use  the  following  MML  notation  in  the  PT  for  the  ASSIGN 
command: 

AND      'ASSIGN  <OUAL  OPT-T>  <$DEV  EHR-< ' Inval id  device>> 

If  the  parser  cannot  parse  the  input  DCI.  command  line  text  that 
corresponds  to  the  device  specification  (SDEV) ,  the  parser  prints  the 
message  "ASSIGN  —  Invalid  device",  and  aborts  the  parse. 


12.10.8   HLP 

Use  HLP  (HeLP)  in  a  PT  only  to  associato  help  text  with  syntax 
elements  that  have  the  PRO  attribute  (Section  12.10.12)  specified. 
When  the  parser  i;  prompting  and  a  "?"  character  is  input,  the  parser 
spawns  a  HELP  command.  The  parser  appends  the  text  specified  in  the 
HL  attribute  to  the  HELP  command  "HELP  command"  where  "command"  is 
the  name  of  the  DCL  command  being  processed. 

The  format  of  the  HLP  attribute  is  as  follows: 

HLP-'string 

or 

HLP=label 

label:   HELP  </string/> 

where 

string   Appended  to  the  HELP  command 

label    Label  of  a  HELP  macro 

The  parser  appends  the  string  to  the  command  "HELP  command",  where 
"command"  is  the  name  of  the  current  command  being  processed.  For 
example,  if  you  specify  the  PT  for  ASSIGN  as: 

AND      <QUAL  OPTR-T>  <$DEV  PRO='Dcvice?   HLP-<' Logical  name>> 

and  the  user  types  a  "?"  in  response  to  the  prompt  "Device?",  the 
parser  forms  and  spawns  the  command  "HELP  ASSIGN  LOGICAL  NAME". 

This  requires  a  file  named  DCLASSIGN.HLP  containing  the  necessary  help 
text.  For  the  format  of  the  HELP  file,  see  the  HELP  documentation  in 
the  RSX-llM/M-PLUS  Command  Language  Manual  or  the  RSX-llM/M-t LUS  MCR 
Operations  Manua"f7 


12.10.9   MAP,  DMAP 

MAP  is  legal  in  both  the  PT  and  the  TT.  However,  the  parser  and  the 
translator  interpret  MAP  differently.  The  following  summarizes  the 
types  of  legal  MAP  attributes  in  a  parser  table. 

MAP"n  Instructs  the  parser  to  queue   the   specified   primary 

mapping   number   n   to   the   IFORM   queue   only  if  the 
associated  syntax  element  is  successfully  parsed. 
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NAP-<,nl>  Instructs  the  parser  to  queue  the  specified  secondary 
■tapping  number  nl  to  the  IPORM  queue  only  if  th'S 
associated  syntax  element  is  sucessfully  parsed. 

Note  that  specifying  COP  with  MAP  in  a  FT  Instructs  the  parser  to 
create  and  attach  a  character  buffer  to  the  mapping  number,  and  copy 
the  text  parsed  by  the  associated  syntax  element  to  the  attached 
character  buffer.  See  Section  12.10.5,  which  describes  COP,  for 
additional  details. 

The  following  summarizes  the  types  of  legal  MAP  attributes  in  a 
translator  table. 

MAP-n  Instructs  the  translator  to   search   the   IPORH   queue 

from  head  to  tail  for  the  specified  primary  mapping 
nudber  n.  If  found,  the  translator  places  the  element 
in  the  MCR  command  line.  If  not  found,  nothing 
happens. 

MAP"<,nl>  Instructs  the  translator  to  search  the  IFORM  queue  for 
the  secondary  mapping  number  nl.  Since  the  object  of 
the  search  is  a  secondary  (not  primary)  mapping 
number,  the  translator  does  not  search  the  entire 
IFORM  queue.  The  translator  starts  searching  at  the 
last  used  primary  mapping  number  and  stops  the  search 
at  the  next  primary  mapping  number.  If  the  secondary 
mapping  number  is  found,  then  the  associated  syntax 
element  is  processed;   otherwise,  nothing  happens. 

MAP-<n,nl>  Instructs  the  translator  to  search  the  IFORM  queue 
from  heaJ  lo  tail  for  the  specified  primary  mapping 
number  n.  If  found,  the  translator  searches  for  the 
specified  secondary  mapping  number  nl.  If  found,  the 
associated  syntax  element  is  processed.  If  not  found, 
another  occurrence  of  primary  mapping  number  n  is 
sought.  If  another  instance  of  primary  mapping  number 
n  is  found,  then  the  translator  looks  again  for  the 
specified  secondary  number  nl.  This  search  process 
continues  until  either  all  primary  mapping  numbers  n 
have  been  found  and  none  of  them  have  a  secondary 
mapping  number  nl  after  them,  or  until  a  primary 
mapping  number  n  Is  found  that  does  have  a  secondary 
mapping  number  nl  after  it. 

If  you  specify  a  MAP  attribute  in  a  TT  without  specifying  an 
associated  syntax  element,  the  translator  examines  the  queue  element 
containing  the  specified  mapping  number  for  an  attached  character 
buffer.  If  the  translator  finds  an  attached  character  buffer,  the 
translator  copies  the  contents  of  the  buffer  to  the  forming  MCR 
command  line  buffer.  If  the  translator  does  not  find  an  attached 
character  buffer,  the  translator  assumes  a  null  syntax  element  (which 
always  processes  successfully). 

To  allow  additional  flexibility  lr>  the  search  for  secondary  mapping 
numbers,  the  translator  supports  ':he  following  additional  formats  for 
specifying  the  MAP  attribute  in  a  TT. 

MAP»<X,nl>  Instructs  the  translator  to  search  the  IFORM  queue 
from  h- id  to  tail  for  the  specified  secondary  mapping 
number  nl.  If  found,  the  translator  processes  the 
associated  syntax  element.  If  not  found,  the 
associated  syntax  element  fails  to  process.  The 
keyword  "X"  identifies  this  MAP  attribute  as  an 
unconditional  seztrch  lor  a  secondary  mapping  numbtr. 
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MAP«<Xl,nl>  Instructs  the  translator  to  seach  the  IPORM  queue  for 
the  secondary  mapping  number  nl.  The  keyword  "XI" 
instructs  the  translator  to  limit  the  search  of  the 
queue  as  follows.  The  search  is  started  at  the  head 
of  the  queue  and  proceeds  until  the  first  primary 
mapping  number  Is  detected.  If  the  secondary  mapping 
number  nl  is  not  found,  then  another  search  is 
conducted.  The  second  search  looks  for  the  socondary 
mapping  number  nl  such  that  it  follows  a  negative 
primary  mapping  number.  If  found,  the  translator 
processes  the  associated  syntax  element.  If  not 
found,  nothing  happens. 

Note  that  you  use  the  "X"  MAP  attribute  to  search  for  a  secondary  like 
a  primary  (that  is,  unconditionally)  and  the  "XI"  MAP  attribute  to 
search  for  floating  command  qualifiers.  For  information  on  floating 
command  qualifiers  sec  Section  12.10.13,  which  doscribeu  QUA. 

When  the  translator  finds  a  mapping  number  and  processes  the 
associated  syntax  element,  the  translator  marks  the  mapping  number  as 
un<>'1.  A  used  mapping  number  cannot  be  found  again  by  the  translator. 
Thus  marking  mapping  numbers  used  prevents  ir.finlte  loops  in  the  TT 
without  the  need  to  specify  termination  conditions.  To  override  the 
marking  of  mapping  numbetz,  use  TST.  To  resdt  all  marked  mapping 
numbers,  use  the  $RESET  predefined  syntax  element.  {This  is  useful 
for  generating  multiple  MCR  comi.ianda  by  msans  of  the  $NEW  predefined 
syntax  element.) 

OMAP  (duplicate  map)  is  identical  to  MAP  in  most  ways.  However,  it  is 
only  allowed  in  a  PT.  DMAP  instructs  the  parser  not  to  queue  the 
mapping  number  to  the  IFORM  queue  if  the  3ame  mapping  number  is 
already  present  in  the  IFORM  queue.  If  the  parser  does  not  queue  the 
mapping  number,  then  the  syntax  element  that  MAP  is  associated  with 
fails  to  process.  Thus,  the  DMAP  attribute  can  prevent  duplicate 
syntax. 

for  additional  information  on  the  use  of  the  MAP  attiibute,  see  the 
Section  12.8,  Mapping  DCL  to  MCR. 

The  following  example  shows  the  use  of  primary  mapping  numbers  with 
predefined  syntax  elements. 

DCL  filespecs,  device  specifications,  numerals,  and  so  forth,  map  to 
themselves.  That  is,  when  a  filespec,  device  specification,  numeral, 
and  so  forth,  is  input,  the  same  filespec,  device  specification, 
numeral,  and  so  forth,  is  output.  Here  is  an  example  of  how  a 
terminal  device  specication  maps  to  itself. 

Parser  Table 

TERM;   AND  'TERMINAL:   <$DEV,MAP-2> 
END 

Translator  Table 

MRET:   AND  'TERM-  <MAP=2> 
END 

The  parser  table  specifies  at  label  TERM:  If  the  input  command  line 
matches  a  device  specification  ($DEV) ,  then  queue  mapping  number  P2  to 
the  IFORM  queue,  attach  a  character  buffer  to  this  queue  element,  and 
copy  the  device  specification  to  the  attached  character  buffer.  The 
translator  table  specifies  at  label  MRET:  If  P2  is  in  the  IFORM 
queue,  then  output  the  contents  of  any  attached  buffer  to  the  forming 
MCR  command  line. 
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Th«  following  •xampl*  Illustrates  the  use  of  secondary  mappings. 

Wh«n  translating  the  DCL  MACRO  command  to  the  MCR  MAC  command,  it  is 
nessessary  to  determine  which  (if  any)  input  filespec  has  the 
qualifier  /LIST  oit  it.  That  is,  the  translator  must  be  able  to 
determine  (by  means  of  information  in  the  TT)  that  the  filespec  "C*  in 
the  DCL  command  line  "MACRO  A,B,C/LIST,D"  has  the  /LIST  qualifier  on 
it.  The  IPORM  must  map  the  DCL  filespec  that  has  the  /LIST  qualifier 
on  it  to  the  right  position  in  the  MCR  command  line. 

The  mapping  can  more  easily  be  understood  from  the  viewpoint  of  the 
translator.  The  translator  generates  the  MCR  MAC  command  from  left  to 
right.  When  the  translator  reaches  the  position  in  the  output  MCR 
command  line  where  the  list  file  must  be  placed,  the  translator  looks 
in  the  irORM  queue  for  the  mapping  number  that  represents  the  filespec 
with  the  /LIST  qualifier  on  it.  Since  the  filespec  and  qualifier  are 
two  distinct  syntax  elements,  there  are  two  mapping  numbers  in  the 
IPORM  queue  to  represent  them.  Also,  since  the  IFORM  queue  Is  a 
linear  data  stucture  (and  not  a  tree),  a  means  of  associating  the 
/LIST  qualifier  with  the  filespec  is  needed. 

To  express  an  association  between  elements  in   the   IFOFIM   queue,   use 

primary   and   secondary   mapping  numbers.    Secondary  mapping  numbers 

(such  as  SI)  have  meaning  only  as  related  to  primary  mapping  numbers 
(such  as  PI) . 

The  following  MML  notation  expresses  this  mapping  and  illustrates  the 
use  of  primary  and  secondary  mappings. 

Parser  Table 


AND      'MACRO  FILES 

END 
FILES;   AND      <$FILE  MAP=1>  <'/LIST  OPT-T  MAP-<,1>>  <MORE  OPT-T> 

END 
MORE:    AND      <<',>>  FILES 


END 


Translator  Table 


AND      'MAC  <OBJ  OPT-T>  <LST  OPT-T>  '»  SELIF 
END 
LST:     AND      <<',>>  <MAP-<1,1>> 
END 
SELIF: 


It  is  possible  when  parsing  (due  to  the  recursive  definition  of  FILES) 
to  queue  to  the  IFORM  queue  identical  map  numbers  ("PI")  that 
represent  the  input  filespecs.  The  only  means  of  distinguishing  the 
■Pl"  map  numbers  is  by  their  left-to-right  positioning.  For  the 
translator  to  find  the  "PI"  map  number  that  represents  the  filespec 
with  the  /LIST  on  it,  the  translator  has  to  find  the  "PI"  map  number 
that  is  followed  by  the  "SI"  map  number  such  that  there  are  no 
intervening  "Pn"  map  numbers.  In  MML,  to  instruct  the  translator  to 
perform  such  a  search,  use  the  argument  "<MAP=<1 , 1>>" ,  as  specified  at 
label  LST. 

Remember  that  if  a  reference  is  made  to  a  secondary  map  number  without 

specifying   a   primary   map  number,   then   the  translator  looks  for  a 

secondary  map  number  that  is  associated  with  the  last  used  primary  map 
number. 
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12.10.10   NO 

NO  is  allowed  only  in  a  PT.  NO  Instructs  the  parser  to  process  either 
a  literal  "NO"  or  a  literal  "-"  before  it  processes  the  associated 
literal.  The  NO  attribute  is  legal  only  when  associated  with  a 
literal  syntax  element.   The  format  for  the  NO  attribute  is: 

NO-T 

If  you  specify  a  MAP  with  a  NO,  the  parser  queues  two  different 
mapping  numbers.  If  the  parser  does  not  process  either  the  "NO"  or 
the  "-",  the  parser  queues  the  mapping  number  assigned  to  NAP.  If  the 
parser  does  process  either  the  "NO"  or  the  "-",  the  parser  Increments 
the  mapping  number  by  one  before  it  queues  the  mapping  number. 

The  following  Illustrates  the  use  of  NO: 

cm       <'LIST  MAP-10.   NO-T> 

In  this  example,  the  parser  attempts  to  parse  either  NOLIST,  -LIST,  or 
LIST.  If  LIST  is  parsed,  the  parser  adds  the  mapping  number  10  to  the 
IPORM  leue.  If  either  NOLIST  or  -LIST  is  parsed,  the  parser  queues 
the  mapping  number  11. 


12.10.11   OPT,  OPTR 

Use  OPT  (OPTional)  to  indicate  that  a  syntax  element  is  not  required. 
You  can  use  OPT  In  both  the  PT  and  the  TT.  The  parser  and  the 
translator  interpret  OPT  identically. 

The  format  for  OPT  Is  as  follows: 

OPT-T 

For  example,  to  specify  that  qualifiers  (label  QUAL)  are  optional 
syntax  in  the  ASSIGN  command,  use  the  following  MML  notation: 

AND      'ASSIGN  <OUAL  OPT-T>  ... 

The  parser  goes  to  label  QUAL  and  processes  the  syntax  defined  at 
label  QUAL.  If  the  parser  cannot  process  a  syntax  element  in  an  AND 
macro,  the  failure  implies  the  failure  of  the  AND  macro.  The  OPT-T 
attribute  tells  the  parser  to  ignore  the  failure  and  continue 
processing  the  AND  macro  with  the  next  (left-to-right)  argument  to  the 
AND  macro. 

Use  OPTR  (OPTional  Repeat)  in  the  same  way  to  indicate  that  a  syntax 
element  is  not  required.  In  addition,  use  OPTR  to  Indicate  that  the 
syntax  element  can  be  used  repeatedly  in  the  pat  -e/translatlon  until  a 
failure  results.  In  other  words,  the  presence  of  OPTR  indicates  that 
the  syntax  element  can  be  used  to  parse  or  translate  syntax  from  zero 
to  an  infinite  number  of  times. 

The  format  for  OPTR  Is  as  follows: 

OPTR«T 

For  example,  to  specify  that  qualifiers  (label  QUAL)  are  optional 
syntax  in  the  ASSIGN  command  and  that  the  qualifiers  can  be  used 
repeatedly  in  the  Input  command  line,  use  the  following  MML  notation: 

MID      'ASSIGN  <QUAL  OPTR»T>  ... 
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The  parser  goes  to  label  QUAL  and  processes  the  syntax  defined  there. 
If  a  syntax  element  In  an  AND  macro  fails,  the  failure  cannot  be  used 
in  the  parse,  implies  the  failure  of  the  AND  macro.  The  OPTR-T 
attribute  tells  the  parser  to  ignore  failure  and  to  continue 
processing  the  AND  macro  with  the  next  (left-to-right)  argument  to  the 
AND  macro.  However,  if  and  while  the  syntax  defined  at  label  QUAL 
matches  the  input  command,  the  parser  uses  it  repeatedly. 

If  the  OPT  and  AND  attributes  are  used  in  the  same  syntax  element,  the 
OPT  modifies  the  AND.  That  is,  the  OPT  does  not  modify  the  entire 
syntax  element. 

For  example,  here  is  a  fragment  of  code  based  on  the  LINK  command 
translator  table.  The  TT  specifies  a  TKB  switch  that  can  be  specified 
with  or  without  arguments  attached. 


OR. 
■MO 


<VPR  MAP-1  AND-PRIV  OPT-T> 


PRIV: 


AND 
END 


•:  <MAP-3> 


In  the  example,  the  optional  argument  to  the  /PR  switch  is  attached  to 

mapping   number  3.    The  OPT  applies  to  AND-PRIV  and  not  to  the  whole 

syntax  element.  If  the  OPT  applied  to  the  entire  syntax  element,  then 

the   entire   OR  macro,  of  which  this  fragment  is  a  part,  would  always 
succeed. 


12.10.12   PRO 

Use  PRO  (PROmpt)  in  the  PT  to  associate  prompt  strings  with  syntax 
elements.  If  the  parser  detects  end-of-line  while  processing  a  syntax 
element  that  has  the  PRO  attribute  specified,  the  parser  prints  the 
prompt  string  specified,  and  suspends  itself  to  wait  for  more  input. 
The  parser  appends  any  input  received  to  the  input  DCL  command  line. 
PRO  is  legal  only  in  the  PT.   The  translator  does  not  prompt. 

The  format  of  PRO  is  as  follows: 

PRO- 'string 

or 

PRO-label 

label:   PROMPT  </string/> 

where 

string   ASCII  string  to  be  used  as  the  prompt  string 

label    (MACRO-II)  label  of  a  (MACRO-11)  PROMPT  macro 

Thus,  specify  the  prompt  string  directly  after  the  "■"  symbol,  or  as 
the  argument  to  the  PROMPT  macro.  The  PROMPT  macro  allows  global 
prompt  strings,  which  conserve  space. 
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The  following  «xampl«  illustrates  the  use  of  PRO: 

AND  <OUAL  OPTR-T>  <$DBV  PRO-' Devlce?>  <$DEV  PRO-PRODEV> 

PRODEV:   PROMPT  </Logical  device?   /> 

The  command  requires  two  device  specifications  ($DEV).  If  the  parser 
expects  the  first  $DEV  but  reaches  the  end  of  the  line,  then  the 
parser  prompts: 

Device? 

If  the  parser  expects  the  second  $DEV  but  reaches  the  end  of  the  line, 
then  the  parser  prompts: 

Logical  dsvice? 

12.10.13   QUA 

Use  QUA  (QUAlifier)  to  specify  qualifiers.  You  can  specify  floating 
or  positional  qualifiers.  Floating  qualifiers  are  qualifiers  that  are 
legal  anywhere  in  the  input  DCL  command  line.  Positional  qualifiers 
are  qualifiers  that  are  legal  only  at  specific  positions  in  the  input 
DCL  command  line  or  output  MCR  command  line. 

The  positional  form  of  the  QUA  attribute  is  legal  in  both  a  PT  and  a 
TT.   The  floating  form  is  legal  only  in  a  PT, 

The  format  for  QUA  is  as  follows: 

QUA-label 
where 

label    Nonliteral  (address  of  an  AND  or  OR  macro) 

When  the  QUA  attribute  is  used  in  a  PT  and  the  parser  encounters  a 
slash  (/)  in  an  appropriate  location,  it  attempts  to  match  the  text 
following  the  slash  with  one  of  the  elements  of  the  AND  or  OR  macro  at 
the  specified  label.  If  an  end-of-linr  is  encountered  after  the 
slash,  the  parser  issues  a  prompt.  If  an  illegal  qualifier  is  given, 
then  an  error  message  is  printed  and  the  parse  is  aborted.  The  list 
of  qualifiers  is  repeatedly  scanned  until  all  qualifiers  in  the  input 
command  line  have  been  parsed. 

To  specify  a  positional  QUA  attribute,  use  QUA  as  part  of  a  syntax 
element.   For  instance: 


OUAL: 


AMD 

<'ASSIGN,3 

■ND 

OR 

<'GL0BAL,1> 

OR. 

<• LOCAL, 3> 

OR. 

<'L0GIN,3> 

OR. 

TERM 

IMD 

I:i  this  case,  any  qualifiers  (such  as  /GLOBAL)  must  immediately  follow 
'ASSIGN"  in  the  command  line.  (See  the  following  example  for  more 
details  on  how  the  QUA  attribute  works.) 
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To  apacify  floating  qualifiara  uaa ,  QUA  an  a  v^parate  argument  to  an 
AND  macro,  not  as  part  of  another  argument.  The  parser  attempts  to 
match  the  qualifiers  defined  at  the  l2bel  before  and  after  it 
processes  each  argument  of  the  AND  macro.  That  is,  the  qualifiers 
float  before  and  after  each  syntax  element  defined  by  the  AND  macro. 
Furthermore,  the  parser  .tttenpts  to  parse  the  floating  qualifiers 
after  any  prompts.  If  OUA  is  being  used  to  specify  floating 
qualifiers,  it  must  be  an  argument  to  an  AND  macro,  rather  than  an 
AND.  (extension)  macro.  The  floating-qualifier  form  of  QUA  is  legal 
only  in  a  PT. 

The  following  'llustrates  the  floating-qualifier  form  of  QUA: 


QUAL: 


The  label  QUAL  defines  the  allowable  qualifiers.  The  parser  checks 
for  the  qualifiers  biifore,  between,  and  after  the  $DFV  syntax 
elements.  Before  the  parser  transfers  parsing  control  to  the  OR  macro 
at  label  QUAL,  the  parser  attempts  to  parse  the  slash  "/"  character 
Only  if  the  parser  successfully  parses  the  slash,  does  it  attempt  t^ 
parse  the  qualifiers  defined  at  label  QUAL.  If  the  parser  detects  the 
end  of  the  input  DCL  command  line  after  it  parses  a  slash  character, 
the  parser  prompts  for  more  input.  If  a  slash  is  detected  and  the 
qualifiers  defined  at  label  QUAL  fail  to  process,  the  parser  issues  an 
error  message  and  aborts  the  parse.  The  parser  repeatedly  attempts  to 
parse  the  qualifiers  until  it  no  longer  can  parse  a  slash  character. 

Thus,   using   QUA   in   the   previous   example  !.s      equivalent   to   the 
following : 


AND 

'ASSIGN,  3 

END 

OR 

<• LOCAL, 3> 

OR. 

<'L0GIN,3> 

OR. 

<'GL0BAL,1> 

OR. 

TERM 

END 

o 


AND      <QUAL  OPTR-T>  $DEV  <QUAL  0PTR-T>  $OEV  <QUAL  0PTR-T> 
END 

QUALj    and      V  <QUAL1  PRO-'Qualif ier?  ERR-< ' Illegal  qualifier>> 

QUALl:   OR       <• LOCAL, 2> 

OR.     <'log:n,2> 

OR.      <'GL0BAL,1> 
END 

The  following  illustrates  the  use  of  the  QUA  attribute  in  a  TT. 

ASN::    AND  <<'ASN  >>  <MAP»1>  '»  <MAP-2  QUA«LAUQ> 
END 

LAUQ:    OH  <'GBL      MAP-4> 
OR.  <'LOGIN   MAP-3> 
OR.  MRET 
END 

The  label  LAUQ  defines  the  MCR  switches  equivalent  to  the  DCL 
qualifiers.  The  translator  processes  QUP  just  as  does  the  parser. 
However,  instead  of  parsing  the  input  DCL  command  line  for  qualifiers, 
the  translator  uses  the  qualifiers  to  construct  the  equivalent  MCR 
command  line.  Remember  that  QUA  automatically  includes  slashes  before 
each  switch. 
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12.10.14   TST 

TST  Is  Isqal  only  in  a  TT  and  only 
Instructs  the  translator  not  to 
translation  as  havin«j  b««n  ussd. 


when   specified   with   MAP.    TST 
mark   a  mapping  element  used  In  a 


The  format  of  the  TST  attribute  Is  as  follows: 

TST-T 
The  following  Illustrates  the  use  of  the  TST  attribute: 

MCRCOP: 


OR 

<PIP 

HAP-1  TST"T> 

OR. 

<PIP 

MAP-2  TST-T> 

OR. 

<NFT 

MAP-3> 

END 

In  the  previous  example,  the  OR  macros  Instruct  the  translator  to 
process  the  nonllteral  PIP  If  either  mapping  numbers  1  or  2  are  In  the 
IPORM  queue,  or  to  process  the  nonllteral  NPT  If  mapping  number  3  Is 
in  the  IPORM  queue.  The  TST  attribute  associated  with  the  syntax 
element  PIP  Instructs  the  translator  not  to  mark  mapping  numbers  2  or 
3  as  having  been  used.  This  allows  the  syntax  defined  at  label  PIP  to 
use  th*se  mapping  numbers  also. 


12.11   PREDCPINBD  SYNTAX  ELBNBNTS 

Predefined  syntax  elements  (PSEs)  are  syntax  elements  defined  for  use 
by  all  DCL  command  tables.  PSE  names,  by  convention,  are 
distinguished  from  local  category  names  by  having  a  *$"  as  their  first 
character . 


NOTE 


If  the  syntax   of   a 
match    that    of   a 
element,  then  the  par 
PSEs   have  two  forms, 
"E"  and  one  not,  such 
$PIL  and  SPILE,  $DEV 
and   SUICE.    The   fo 
produces    an   error 
aborting  the  parse, 
does   not.    Use   the 
defining  optional  syn 


command  does  not 
predefined   syntax 

se  falls.  Several 
one  ending  with  an 
as  $NOD  and  $NODE, 

and  SDEVE,  eind  $UIC 

rm   ending   In   "E" 

message    before 

The   shorter   form 

shorter  form  when 

tax. 


The  following  list  briefly  defines  the  PSEs.  Note  that  some  PSEs 
require  arguments.  Specify  the  required  arguments  In  the  order  shown 
and  enclose  the  PSE  and  the  arguments  In  angle  brackets  to  Identify 
the  PSE  and  arguments  as  one  argument  to  the  MACRO-11  assiembler. 


12.11.1   Basic  Data  Types 


The  following  list  of  PSEs  define  basic  data  types  in  MML.  You  ca 
use  them  only  in  a  PT.  The  parser  copies  to  an  IPORM  character  buffe 
the  text  In  the  Input  DCL  command  line  that  fits  the  structure  define^ 
by  the  PSE.  The  buffer  is  attached  to  the  last  queued  mapping  number 
and  can  be  accessed  bv  the  translator  ^or  use  in  constructing  the 
equivalent  MCR  command  line. 


can 

r 
d 
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$NUM,A1,A2 


Defines  the  structure  or  syntax  of  a  numeric  string 
(0  through  9).  The  arguments  Al  and  A2  designate  the 
minimum  and  maximum  length,  respectively,  for  the 
numeric  string.  Additionally,  the  PSE  allows  an 
optional  decimal  point  on  the  end  of  the  string.  The 
decimal  point  is  not  copied  to  the  IfORM  character 
buffer . 


$DNUM,A1,A2 


$0NUM,A1,A2 


$W0NUM,A1,A2 


$D0NUM,A1,A2[.] 


Defines  the  structure  or  syntax  of  a  decimal  numeric 
string  (0  through  9).  The  arguments  Al  and  A2 
designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string.  Additionally, 
the  PSE  allows  an  optional  decimal  point  on  the  end 
of  the  string.  A  decimal  point  is  copied  to  the 
IFORM  character  buffer  whether  or  not  it  is  specified 
in  the  input  DCL  command  line. 

Defines  the  structure  or  syntax  of  an   octal  numeric 

string   (0   through   7).    The   arguments   Al  and  A2 

designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string. 

Defines  the  structure  or  syntax  of  SONUM  or  the 
v.'ilc'c^rd  character  "*".  The  arguments  Al  and  A2 
deiii'^nate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string. 

Defines  t'le  structure  or  syntax  of  a  decimal  or  octal 
numeric  string  (0  through  9).  The  argunents  Al  and 
A2  designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string.  Additionally, 
the  PSE  allows  an  optional  decimal  point  on  the  end 
of  the  string.  A  decimal  point  is  copied  to  the 
IFORM  character  buffer  if  either  the  input  DCL 
command  line  or  the  parsed  string  contains  the 
characters  8  or  9. 


$WD0NUM,A1,A2 


$BNUM,A1,A2 


$ALF,A1,A2 


$ALFN,A1,A2 


$WALPN,A1,A2 


Defines  the  structure  or  syntax  of  $DONUM   or   a  "*" 

character.    The   arguments   Al   and  A2  designate  the 

minimum  and  maximum  length,  respectively,  for  the 
numeric  string. 

Defines  the  structure  or  syntax  of  a   binary  numeric 

string   (0   through   1).    The   arguments   Al  and  A2 

designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string. 

Defines  the  structure   or  syntax   of   an   alphabetic 

string   (A   through   Z) .  The   arguments   Al   and  A2 

designate  the  minimum  and  maximum  length  for  the 
alphabetic  string. 

Defines  the  structure  or  syntax  of  an  alphanumeric 
string  (0  through  9  and/or  A  through  Z) .  The 
arguments  Al  and  A2  designate  the  minimum  and  maximum 
length  for  the  alphanumeric  string. 

Defines  the  structure  or  syntax  of  $ALFN  with  the 
additional  characters:  "*"  and  "%".  These 
characters  are  used  by  some  RSX-llM/M-PLUS  utilities 
as  wildcard  characters.  The  arguments  Al  and  A2 
designate  the  minimum  and  maximum  length  for  the 
alphanumeric  string. 


# 
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$R50,A1,A2 


Defines  the  structure  or  syntax  of  a  Radlx-50  string 
(0  through  9,  A  through  Z,  "$",  and  ".").  The 
argumen;:s  Al  and  A2  designate  the  minimum  and  maximum 
length  for  the  Radix-50  string. 


12.11.2  Comon  Coanand  Blementa 

The  following  PSEs  define  parts  of  the  DCL  command  grammar.  You  can 
use  them  only  in  a  PT.  The  text  (except  for  $DATE)  parsed  from  the 
input  DCL  command  line  that  fits  the  structure  defined  by  the  PSE  is 
copied  to  an  IFORM  character  buffer  that  is  attached  to  the  last 
queued  mapping  number. 


$FIL 


$FILE 
$WFIL 
$WFILE 

$NFIL 
$NFILE 

$IFIL 
$IFILE 

$NOD 
$NODE 


Defines   the 
sped  f  ication. 
filespec  sets  a 
These  are; 


structure   or   syntax   of   a    file 

Each  element  explicitly  included  in  the 

bit   in  the  global   bit-mask  words. 


device  B28 
UIC  B29 
filename  B30 


filetype  B31 
version  B32 


These   bits   are   also   set 
predefined  syntax  elements. 


by  the   other   $FIL-based 


Defines  the  structure  or  syntax  of  $FIL.  Additionally, 
if  the  parser  fails  to  process  $FILE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

Defines  the  structure  or  syntax  of  $FIL.  Additionally, 
the  wildcard  chaiacters;  "*"  and  "%"  are  allowed  as 
part  of  the  file  specification. 

Defines  the  structure  or  syntax  of  SWFIL. 
Additionally,  if  the  parser  fails  to  process  $WFILE, 
the  parser  issues  an  error  message  and  aborts  the 
parse. 

Defines  the  structure  or  syntax  of  $WFIL  if  preceded  by 
a  DECnet  node  specification. 

Defines  the  structure  or  syntax  of  $NFIL. 
Additionally,  if  the  parser  fails  to  process  $NFILE, 
the  parser  issues  an  error  message  and  aborts  the 
parse. 

Defines  the  structure  or  syntax  of  $FIL.  Additionally, 
the  indirect  file  indicator  "§"  must  prefix  the  file 
specification. 

Defines  the  structure  or  syntax  of  $IFIL. 
Additionally,  if  the  parser  fails  to  process  $IFILE, 
the  parser  issues  an  error  message  and  aborts  the 
parse. 

Defines  the  structure  or  syntax  of  a  DECnet  node  name 
specification. 

Defines  the  structure  or  syntax  of  $NOD.  Additionally, 
if  the  parser  fails  to  process  $NODE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 
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$DEV 
$DEVE 

$ODEV 

$ODEVE 

$UIC 
$UICE 

$WUIC 

$WUICE 

SOUIC 
$OUICE 

$DATE 


Defines   the   structure 
specification. 


or   syntax   of 


device 


$DATE1 


$TIME 


Defines  the  structure  or  syntax  of  $DEV.  Additionally, 
if  the  parser  fails  to  process  $DEVE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

Defines  the  structure  or  syntax  of  $DEV.  Additionally, 
the  character  ":"  is  optional  syntax. 

Defines  the  structure  or  syntax  of  SODEV. 
Additionally,  if  the  parser  fails  to  process  $ODEVE, 
the  parser  issues  an  error  message  and  aborts  the 
parse. 

Defines  the  structure  or  syntax  of  a  UFD  specification. 

Defines  the  structurt?  or  syntax  of  $UIC.  Additionally, 
if  the  parser  fail3  to  process  $UICE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

Defines  the  structure  or  syntax  of  $UIC.  Additionally, 
the  wildcard  character  "*"  is  allowed  as  part  of  the 
UIC  specification. 

Defines  the  structure  or  syntax  of  SWUIC. 
Additionally,  if  the  parser  fails  to  process  $WUICE, 
the  parser  issues  an  error  message  and  aborts  the 
parse. 

Defines  the  structure  or  syntax  of  lUIC.  Additionally, 
the  characters  "[",  "]",  and  ","  are  optional  syntax. 

Defines  the  structure  or  syntax  of  SOUIC. 
Additionally,  if  the  parser  fails  to  process  SOUICE, 
the  parser  issues  an  error  message  and  aborts  the 
parse. 


Defines  th 
specif icatio 
two  forms 
following  d 
is  attached 
is  attached 
year  is  atta 
output  forma 
characters  o 
slash  format 


e    structur 
n.    A   date 
mm/dd/yy  or 
ata  structur 
to  secondary 
to   second 
ched  to  seco 
t  is  always 
f  the  month 
(with  the  n 


e  or  syntax  of  a  date 
specification  can  take  one  of 
dd-mmm-yy.  $DATE  produces  the 
es  in  the  IFORM  queue:  the  day 
mapping  number  210,  the  month 
ary  mapping  number  211,  and  the 
ndary  mapping  number  212.  The 
dd-mmm-yy  (with  the  first  three 
name  spelled  out)  even  if  the 
umber  of  the  month)  is  used. 


For  commands  that  require  two  dates  (for  example,  SINCE 

and   THROUGH),   a   second   PSE   for  dates,  $DATE1,  uses 

secondary  mapping  numbers  213,  214,  and   215   for   the 

day,  month,  and  year  respectively.  SDATEl  is  otherwise 
identical  to  $DATE. 


Defines    the 
specification. 
hh:mm[ :ss] . 


structure    or    syntax    of    a    time 
The   time  specification  is  of  the  form 
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12.11.3  Special  Parser  Elanants 

You  can  specify  the  following  PSEs  only  in  a  PT. 

$ALL, label  Defines  the  syntax  or  structure  of  an  arbitrary  string 
of  characters.  $ALL  matches  all  characters  in  the 
command  line  (left-to-right)  until  any  one  of  a  set  of 
specified  terminating  characters  is  detected.  The  set 
of  terminating  characters  are  specified  with  the 
TERMINATORS  macro.  The  label  is  a  label  on  the 
TERMINATORS  macro.  The  text  parsed  from  the  input  DCL 
command  line  that  fits  the  structure  defined  by  $ALL  is 
copied  to  an  IFORM  character  buffer  that  is  attached  to 
the  last  queued  mapping  number. 

Here  is  an  example  of  $ALL  with  the  TERMINATORS  macro: 


AND.  <$ALL, EXCEPT) 


EXCEPT:  TERMINATORS  '"  ')  ')  $EOL 


This  example  allows  the  ","  the  ")",  and  the  "]"  as 
terminators,  in  addition  to  the  $EOL  predefined  syntax 
element,  discussed  next. 

$EOL  $EOL  is  used   to   parse   end-of-line   characters.    For 

instance,  in  the  previous  example,  a  carriage-return  or 
escape  would  also  be  acceptable  as  a  terminator. 

$COP,*llt  $COP  does  not  define  syntax.  SCOP  instructs  the  parser 
to  copy  the  specified  literal,  'lit,  unconditionally  to 
an  IFORM  character  buffer.  The  IFORM  character  buffer 
is  always  attached  to  the  last  queued  mapping  number. 

$DSB  $DSB  (disable  skip   blanks)   does   not   define   syntax. 

$DSB  instructs  the  parser  not  to  skip  blanks. 
Normally,  blanks  are  ignored.  $DSB  and  $ESB  must  be  in 
the  same  syntax  element,  such  as  AND  or  OR,  but  need 
not  be  on  the  same  line. 

$ESB  $ESB  (enable  skip  blanks)  does  not  define  syntax.   $ESB 

restores  the  default  state,  which  is  to  ignore  blanks. 

For  example,  a  filespec  cannot  include  blanks.  The 
following  could  define  a  filespec: 

$DSB  SDEV  SUIC  <$ALFN,0,9>  '.   <$ALFN,0,3>  ';   <SONUM,0,3>  SESB 

(The  actual  filespec  definition  is  more  complex.  This 
is  only  an  example.) 

$DDR  $DDR  does  not  define  syntax.   $DDR  instructs  the  parser 

to  disable  delimiter  recognition.  Delimiter 
recognition  is  enabled  by  default  and  instructs  the 
parser  to  ensure  that  all  literal  syntax  elements  have 
delimiting  characters  terminating  them.  $DDR  must  be 
used  on  the  same  line  with  $EDR.   See  the  next  example. 
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$EDR 


$SEP 

$OSEP 

$CSEP 

$COSEP 

$FSEP 

$TERM 

$PROC 

$PRONC 


Enable  delimiter  recognition.  This  is  the  default 
case . 

For  example,  the  following  line  allows  you  to  attach 
the  first  one  to  three  characters  to  one  mapping  number 
while  the  remainder  are  attached  to  another. 

COMl:   AND  $DDR  <$R50,1,3  MAP-1>  <$R50,0,7  MAP-2>  $EDR 
END 

Notice  that  no  delimiting  character  distinguishes  the 
two  strings,  and  that  the  second  string  may  be  null. 

$SEP  defines  the  colon  (:)  or  equals  (■).  These  are 
used  as  separators  between  qualifiers  and  arguments. 

$OSEP  defines  an  optional  separator,  that  is  colon, 
equals,  or  nul 1 . 

$CSEP  is  the  same  as  $SEP,  but  additionally  copies  a 
colon  to  the  IFORM. 

$COSEP  is  the  same  as  $OSEP,  but  additionally  copies  a 
colon  to  the  IFORM  whether  anything  is  input  or  not. 

$FSEP  defines  the  comma  (,)  and  plus  (-*■)  as  filespec 
separators. 

$TERM  defines  a  terminal  specification  and  copies  it  to 
the  IFORM. 

$PROC  defines  a  processor  name  for  the  Queue  Manager  as 
either  a  device  name  followed  by  a  colon  or  six 
RadIx-50  characters  followed  by  a  colon. 

SPRONC  defines  a  processor  name  for  the  Queue  Manager 
as  a  device  name  followed  by  a  colon  or  six  Radix-50 
characters  not  followed  by  a  colon. 


12.11.4  Special  Translator  Elements 


You  can  specify  the  following  PSEs  only  in  a  TT. 


$NEW 


$RESET 


$FNAM 


$SY 


Used  to  indicate  the  start  of  an  additional  MCR  command 
line.  $NEW  instructs  the  dispatcher  subprocess  of  the 
DCL  task  that  there  are  multiple  MCR  commands  that  must 
be  dispatched  serially. 

Used  to  reset  the  IFORM  queue.  Resetting  the  IFORM 
queue  allows  all  used  mapping  numbers  to  be  reused. 
SRESET  is  designed  to  be  used  with  $NEW  to  define 
multiple  MCR  commands. 

Used  to  specify  that  only   the   file   name   in   a  file 

specification   is   to  be  copied  to  the  MCR  command  line 

buffer  as  a  result  of  unmapplng  a  mapped  file 
specification. 

Converts  the  assigned  device  for  SY:  to  ASCII  and 
appends  it  to  the  MCR  command  line;   for  examnle,  DB2:. 
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$TI 


$CUIC 


$LUIC 


Converts  the  assigned  terminal  device  Cor  TI:   to  ASCII 

and   appends  It  to  the  MCR  command  line;   for  e>.ample, 
TT 1 5 : . 

Converts  the  current  UIC  for   the   user   to  ASCII   and 

appends   it  to   the   MCR  command   line;   for  example, 
[301,1131. 

Converts  the  login   UIC   for   the   user   to  ASCII   and 
appends  it  to  the  MCR  command  line. 


12.11.5  Program  Control  Elements 


You  can  specify  the  following  PSEs  In  either  a  PT  or  a  TT. 


$JSR,A 


$TST 


$TSTNOT 


$LOAD,name 


$CALLOV,name 


$NULL 

$AB 
$BA 


A  special  category  used  to  gain  control  of  the  CPU. 
The  argument  A  must  be  the  label  of  a  MACRO-11 
subroutine.  To  indicate  faJlure,  the  MACRO-11 
subroutine  should  (on  return)  set  the  carry  bit  to 
indicate  failure  and  clear  it  to  indicate  success. 
Remember,  the  routine  must  be  in  the  blank  program 
section. 

$TST  is  used  to  test  if  a  mapping  number  is  in  the 
IFORM  queue.  A  MAP  attribute  specifies  the  mapping 
number.  $TST  succeeds  only  if  the  mapping  number  is  in 
the  IFORM  queue;   for  example,  <$TST  MAP-1>. 

$TSTNOT  is  used  to  test  If  a  mapping  number  is  not  in 
the  IFORM  queue.  A  MAP  attribute  specifies  the  mapping 
number.  $TSTNOT  succeeds  only  if  the  mapping  number  is 
not   in   the   IFORM  queue.   The  syntax  is  identical  to 

$TST. 

$LOAD  is  used  to  load   an   overlay   from  a   parser   or 

translator   table.    The   argument  "name"  specifies  the 

name  of  the  overlay  as  specified  in  the  overlay 
description  file. 

$CALLOV  is  used  to  load  and  activate  part  of  either  a 
parser  or  translator  table.  The  starting  address 
within  the  overlay  must  be  contained  in  the  first  word 
of  the  overlay.  Use  .WORD  to  spe::ify  the  address.  On 
return,  the  previous  overlay  is  loaded.  The  argument 
"name"  specifies  the  name  of  the  overlay  as  specified 
in  the  overlay  description  file. 

$NULL  is  used  to  execute  attributes  without  specifying 
a  syntax  element.  $NULL  succeeds  if  the  attributes 
succeed. 

$AB  (angle  bracket)  is  equivalent  to  the  literal  "<" 
and  is  used  to  pass  the  "<"  as  an  argument  to  MACRO-11. 


$BA  is  equivalen^.  to  the  literal  ">"   and 
pass  the  ">"  as  an  argument  tc  MACRO-11. 


is   used   to 
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12.11.6  Bxaapl*  froa  DCL  Cownand  Tables 


.TITLE 

ASSIGN 

. IDENT 

/OO/ 

.P8ECT 

.CDEF 

.CNABL 

LC 

THIS  SOFTUARC  IS  FUKMISHED  UNDER  A  LICENSE  AND  HAY 
K  USED  OR  COPIED  ONLY  IN  ACCORDANCE  UITH  THE  TERNS 
OF  SUCH  LICENSE. 

COPYRIGHT  (c>  11981  DY  DIGITAL  EOUIPHENT  CORPORATION. 
ALL  RIGHTS  RESERVEH. 


author: 
date: 
nodified! 
function! 


J.H.  SALNAN 

07-OCT-eO 

DATE     ABSTRACT 


TRANSLATE  THE  DCL  COMMANDS  'ASSIGN'*  ' ASSION/OUEUE ' >  ' AUSION/REDIRECT ' t 
'ASSIGN/TASK'  TO  THE  SENANTICALLY  EQUIVALENT  NCR  COMMANDS  'ASN'r  'OUE'> 
'RED't  'REA'. 

THE  FOLLOWING  TADLE  DEFINES  THE  NAPPING  OF  THE  DCL  TO  MCR  SYNTAX: 

DCL  SYNTAX  ELEMENT       NCR  SYNTAX  ELEMENT       HAPPING  LETTER/NUMBER 


<au«u*na**> 
<proc*»«ornj 

<old<l«vic*> 
<n*wd«vlc«> 


<ta«kn«»*> 

<dtvic«> 

<lur.> 

<d»vic«> 

<loaicsld«vlc*> 

/GLOBAL 

/LOGIN 

/TERNINAL-<t*r»d»v> 


<au«>j*na»«> 
<^roc*s«orna««> 

<oIdd*vic*> 
<n»Md«vlc«> 

<ta«l(.n«»*> 

<d«vic*> 

<lun> 

<d«vicii> 

<lafllcaldavic*> 

/GBL 

/LOGIN 

/TERN-<irrftdav> 


PI 

P2 

P3 

P4 

PS 

P6 

P7 

PB. 

P?. 

PIO. 

Pll. 

P12. 

assign: 


queue: 


redir: 


TASK! 


.PAGE 

OR 
iNt 

AND 

AND. 

END 

AND 

AND. 

END 

AND 
AND. 
AND. 
END 


<OUEUE  B8-B1>  <REDIR  BS-B2>  <TASK  B8-B3>  <LOGDEV  B8-B4> 


'/  <'QUEUE>1>  <«PRONC  HAP-1  PRO-tONHSO  ERR-«BQN8G> 
<1PR0C  HAP-2  PRO-»PR.iSG  ERR-«IPHSO> 


'/  <'REDIRECTtl>  <»ODEVE  MAP'3  PRO-«FRHSG> 
<tODEVE  HAP-4  PRO>«T0HSO> 


'/  < 'TASK. 2.  tOSCP  <«R50.t>6  HAP-S  PR0-«TKHS6  ERR-«ITM86> 

<«ODEVE  HAP-A  PR0-«DVMSG> 

<«DNUM>ltS  NAP-7  PR0-«LUMS6  ERR-«NEN8G> 
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.TITLE   A«i"ION 
.lOENT   /OO/ 


INK  DCL  TASK 


LOODEV:  AND 
END 


aUALI 


hcrasn: 


QUE! 


red: 


RE  At 


abn: 


LAUO: 


vterh: 


•DQMSO: 
•DVHSO; 

•frmsg: 
tiPMSo: 

•ITNSO: 
•LDNSO: 
•LUH80: 
•PRHSO: 

•qnhsg: 

«TKH80: 

tiONSo: 


OR 

OR. 

OR. 

OR. 

OR. 

END 

.PAGE 

OR 
END 

AND 
END 

AND 
END 

AND 
END 

AND 

END 

OR 

OR. 

OR. 

END 

AND 

END 

.ENADLE 

ERROR 

PROMPT 

PROMPT 

ERROR 

ERROR 

PROMPT 

PROHPT 

PROMPT 

PROMPT 

PROMPT 

PROMPT 

.DSABLE 

.END 


<«ODEVE  NAP-R.  PR0-«DVN80>  <^«ODEVE  MAP-9.  PRO-«LDMtO>  OUA-QUAL 

<'OLOD*L.l  MAP-10.  CDM-R>>R2> 
'.'LOCAL  (3  CiN-»l> 
<'L0eiNt3  NAP-11.  CDM-I»1> 
<'8YSTEMil  MAP-tO.  C»H-illD2> 
<«TERH  NAP'12.  CtM-D2> 


<aUE  D8T-D1>  <RED  R8T-»2>  <REA  *8T-R3>  <A8N  B8T-D4> 


«'QUe  >>  <MAP-2>  '/as:  <MAf-l> 


<<'RED  >>  <MAf"4>  '■  <MAP-3> 


«'REA  >>  <NAP-S>  «'  >>  <M*r"7>  <<'  >>  <NAP-6> 


<<'A8N  >>  <MAP-8.>  '-  <NAP-y.>  <QUA-LAUQ> 

<'ODL  HAP«10.> 
<'LOOIN  NAP-11. > 
<'TERN>  AND-VTERH> 

<MAP-12.> 

LC 

<./Ill«««l    au»u*    n»m»/> 

</0«vic»t    /> 

</Fro»T    /> 

'/nicaal    processor    na*«/> 

'^/Ill*««l    tatK    r>aa*/> 

</Lr<icaI    <l*vic«T    /> 

</totical    unit?    /> 

</Proc««»orT    /> 

</Bu*u*T    /> 

</Ta«k»    /> 

'•/ToT    /> 

LC 
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CHAPTER    13 
POOL  MONITORING   SUPPORT 


Pool  monitoring  support  controls  the  use  of  the  system's  dynamic 
storage  region  (pool).  This  support  monitors  pool  levels,  restricts 
use,  and  notifies  you  when  pool  is  near  depletion.  This  support 
consists  of  two  parts;  the  RSX-llM/M-PLUS  Executive  pool  monitor 
code,   and    the   privileged    Pool    Monitor   Task    (PMT). 

Pool   monitoring   support   is   not  available  on   unmapped    systems. 


13.1      HOW  YOU  GET   POOL  MONITORING   SUPPORT 

On  R8X-11M  ■ysteas,  you  receive  pool  monitoring  support  when  you 
select  the  pool  Monitoring  support  option  in  system  generation 
(SYSGBN) .  If  you  select  the  option,  you  receive  the  Executive  pool 
■onitor  code  and  SYSGEN  asseables  and  task-builds  PMT.  If  you  do  not 
select  the  option,   you  do  not  receive  any  pool  aonitoring  support. 

On  R8X~11N-PLU8  aysteas,  pool  ■onitoring  support,  including  ths 
Bxscutlvs  pool  ■onitor  code  and  FHT,  la  Inoludad  by  default.  8Y8GK1I 
astabllahaa  the  aupport  for  you.  You  need  not  aalaet  any  option  for 
It.    . 

One  of  PMT's  features  is  that  it  responds  to  extreme  fragmentation. 
Due  to  the  seriousness  o'  this  pool  problem,  PMT  requires  your 
interaction  to  aid  in  system  iecov»?ry.  Therefore,  if  you  select  pool 
monitoring  support,  you  must  be  prepared  to  respond  to  PMT's  prompts 
(see   Section    13.3.4). 


13.2      THE    EXECUTIVE    POOL   MONITOR   CODE 

The  pool  monitor  code  within  the  Executive  monitors  the  amount  of  free 
pool  and  detects  major  pool  events.  When  a  major  pool  event  occurs, 
the  Executive  notifies  PMT  of  the  event  and  of  the  current  condition 
of   pool . 


13.2.1     Pool    Events  Affecting   the   Executive 

The  Executive  pool  monitor  code  responds  to  three  major  pool  events. 
These  events  are  classified  as  either  low  or  high  pool  events.  The 
occurrence  of  these  events  directly  affects  the  condition  of  pool, 
creating  either  a  high  or  low  pool  condition.  The  Executive  responds 
by  notifying  PMT  of  the  pool  event  and  the  resultant  pool  condition 
and  also  activates  PMT.  Any  further  response  to  the  pool  condition  is 
left   to    PMT. 
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13.2.1.1  High  Pool  Bv«nt  -  The  following  is  tha  possible  high  pool 
•vsnt ! 

•  Th«  attainnsnt  of  a   high   pool   condition   from  a   low  pool 
condition. 

This  avant  occurs  whan  a  systan  that  has  a  low  pool  condition 
ralinquishas  enough  pool  to  causa  tha  amount  of  fraa  pool  to  risa 
abova  tha  high  limit. 

Tha  high  pool  limit  is  sat  using  tha  MCR  and  VMR  SET  PLCTL  command. 
Saa  Section  13.4  for  further  discussion  of  the  high  limit. 


13.2.1.2  Low  Pool  Event  -  The  following  are  the  possible  low  pool 
events: 

e  The  degradation  of  pool  from  a  high  pool  condition  to  a   low 
pocl  condition 

e  A  pool  allocation  failure 

The  degradation  of  pool  occurs  when  the  total  amount  of  free  pool  has 
fallen  below  the  low  limit.  A  pool  allocation  failure  occurs  trhen  the 
largest  pool  fragment  is  too  small  for  the  process  requesting  it.  A 
pool  allocation  failure  is  not  to  be  confused  with  future  discussions 
in  this  chapter  of  general  pool  f ragmentritlon  and  extreme  pool 
fragmentation.  Pool  allocation  failures  and  pool  fragmentation  are, 
in  the  context  of  this  chapter,  separate  pool  problems  and  are 
discussed  separately.  See  Section  13.3.1  for  additional  information 
on  pool  fragmentation. 

The  low  pool  limit  is  set  using  the  MCR  and  VMR  SET  /PLCTL  command. 
See  Section  13.4  for  further  discussion  of  the  low  limit. 


13.2.1.3  Pool  Plonitoring  Interface  -  The  mechanism  used  by  the 
Executive  to  detect  pool  events  is  called  the  pool  monitor  interface. 
The  details  of  how  this  interface  works  are  beyond  the  scope  of  this 
manual.  However,  it  is  fully  described  in  the  source  code  for  the 
Executive  module  CORAL. MAC.  CORAL. MAC  is  in  [11,10]  on  your  kit.  In 
summary,  the  interface! 

e  Provides  the  Executive  with  the  ability  to  declare  Information 
to  a  pool  monitor  task. 

a  Provides  the  Executive  with  the  capability  to  receive  a 
response  or  acknowledgemen..  from  a  pool  monitor  task.  (An 
acknowledgement  can  be  used  by  the  Executive  to  control 
further  Information  declarations.) 


13.2.2  Pool  Conditions 

The  condition  of  pool  is  directly  related  to  major  pool  events  and 
also  to  the  acceptable  high  and  low  pool  limits  you  specify.  (You  set 
and  manipulate  these  limits  using  either  the  MCR  or  VMR  SET  /PLCTL 
command  described  In  Section  13.4).  When  a  major  pool  event  occurs 
and  causes  the  size  of  free  pool  to  cross  the  low  or  high  limit,  a  new 
pool  condition  exists.  The  possible  pool  conditions  are  low  pool  and 
high  pool. 
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A  high  pool  condition  •xists  whan  the  anount  of  fr««  pool  la 
aufficlant  to  aupport  currant  and  laaa  dananding  ayatam  workloada. 

A  low  pool  condition  axiata  whan  tha  anount  of  fraa  pool  ia  naaring 
tha  point  whara  ayatam  parfornanca  will  aarioualy  dagrada  if  tha 
ayatam'a  workload  incraaaew. 

Major  pool  avanta  cauaa  aithar  a  high  or  low  pool  condition  to  axiat. 
In  turn,  a  high  or  low  pool  condition,  combina^  with  a  apacific  pool 
fragmentation  laval  ,  creatas  aithar  a  high  or  low  pool  atata.  Pool 
stataa  ara  diacuaaad  in  Saction  13.3. 


13.3   THE  POOL  MONITOR  TASK 

Tha  Pool  Monitor  Task  (PMT)  is  assamblad,  task-built,  and  installed 
during  the  SYSGEN  procedure.  Wh&never  ihe  resultant  system  is  booted, 
PMT  is  activated  by  the  Executive. 

(If  you  do  not  wish  to  use  the  DIGITAL-suppl ied  Pool  Monitor  Task,  you 

do  have   the  option  to  write  and  run  your  own  pool  monitor  task.   if 

you  wish  to  write  your  own  pool  monitor   task,   you  should  first  be 

familiar   with  the  Executive  pool  monitor  interface.  The  interface  is 

documented  in  the  Executive  module  [ 11 , 10]CORAL.MAC.  A  task  installed 

on  a  system  that  supports  pool  monitoring  and  also  has  the  task  name 
"PMT..."  is  considered  to  be  a  "pool  monitor  task".) 

PMT's  first  responsibility  is  to  monitor  pool  conditions.  The 
conditions  that  PMT  responds  to  include  those  detected  and  reported  by 
the  Executive  (see  Section  13.2).  PMT's  second  responsibility  is  to 
monitor  pool  fragmentation.  Through  this  monitoring,  PMT  can  respond 
to  another  major  pool  event  and  also  react  to  extreme  pool 
fragmentation.  The  other  major  pool  event  (not  reported  by  the 
Executive)  occurs  when  PMT  detects  that  the  largest  free  pool  fragment 
is  less  than  the  minimum  required  fragment  size.  (See  Section  13.3.4 
for  further  discussion  of  extreme  fragmentation.) 

Once  it  has  been  activated  by  the  Executive,  PMT  basically  operates  in 
a  cycle.  Whenever  it  receives  the  Executive's  notification  of  a  pool 
condition,  or  at  least  at  regular  time  intervals,  PMT  determines  the 
size  of  the  largest  pool  fragment.  It  then  compares  this  size  to  the 
minimum  required  fragment  size.  Based  on  the  Executive's  report  on 
the  current  pool  condition  and  what  PMT  detects  when  monitoring 
fragmentation,  PMT  determines  what  the  current  state  of  pool  is  and 
responds  to  it  accordingly. 

The  minimum  required  fragment  size  is  set  using  the  MCR  and  VMR  SET 
/PLCTL  command.  See  Section  13.4  for  further  discussion  of  the 
minimum  required  fragment  size. 


13.3.1  Conditions  Affecting  PMT 

PMT  responds  to  pool  fragmentation  and  to  pool   conditions;    however, 
the    response  varies   dependinci   upon   the   current   level   of   pool 


13-3 


POOL  NOMITORING  SUPPORT 

fragmentation.  Ttt*  tto  Icvala  that  Influanct  PMT'a  raaponaa  ara  as 
followai 

•  If  the  largest  fragment  Is  equal  to  or  greater  than  the 
minimum  required  fragment  size,  PMT  then  acts  only  on  the 
condition  of  pool  as  reported  by  the  Executive. 

•  If  the  largest  fragment  becomes  smaller  than  the  minimuM 
required  fragment  size,  PMT  considers  this  to  be  a  low  pool 
event.  If  the  system  is  not  already  in  a  low  pool  state,  this 
event  causes  a  transition  to  that  state.  PMT  then  responds 
accordingly. 

Although  extreme  fragmentation  is  another  pool  event  that  PMT  responds 
to,  it  is  different  from  those  previously  described.  It  is  defined 
and  documented  in  Section  13.3.4. 

PMT  uses  the  information  it  has  concerning  the  current  level  of 
fragmentation  and  also  the  information  provided  by  the  Executive  to 
determine  the  overall  state  of  pool.  Following  is  a  discussion  of 
PMT's  response  to  specific  pool  events  and  conditions. 


13.3.1.1  Pool  Level  and  Pragnent  Site  Are  Satisfactory  -  The 
Executive  notifies  PMT  that  the  pool  level  is  above  the  high  limit  and 
PMT  detects  that  fragment  size  is  greater  than  the  minimum  required 
fragment  size. 

PMT  concludes  that  a  high  pool  state  exists  and  executes  actions 
appropriate  for  a  high  pool  state  (see  Section  13.3.2). 


13.3.1.2  Low  Pool  Condition  -  The  Executive  notifies  PMT  that  a  low 
pool  condition  is  achieved. 

PMT  determines  whether  the  change  in  pool  reported  by  the  Executive  is 
temporary.  The  change  is  temporary  if,  by  the  time  PMT  responds  to 
the  Executive's  notification,  enough  free  pool  has  accumulated  to  push 
the  total  above  the  high  limit.  If  the  change  is  temporary,  PMT 
ignores  the  notification  and  continues  to  execute  high  pool  state 
actions.  If  the  change  is  not  temporary,  PMT  concludes  that  a  low 
pool  state  exists  and  executes  actions  appropriate  for  a  low  pool 
state  (see  Section  13.3.3). 


13.3.1.3  High  Pool  Condition  -  The  Executive  notifies  PMT  tnat  a  high 
pool  condition  is  achieved. 

PMT  determines  whether  the  change  in  pool  reported  by  the  Executive  is 
temporary.  The  change  is  temporary  if,  by  the  time  PMT  responds  to 
the  Executive's  notification,  the  total  amount  of  free  pool  has  moved 
below  the  high  limit.  If  the  change  is  temporary,  PMT  ignores  the 
notification  and  continues  to  execute  low  pool  state  actions.  If  the 
change  is  not  temporary,  PMT  initiates  actions  appropriate  for  a  high 
pool  state  (see  Section  13.3.2). 


13.3.1.4  Largest  Pool  Fragment  Is  Too  Small  -  PMT  detects  that  the 
largest  pool  fragment  Is  smaller  than  the  minimum  required  fragment 
si  ze. 
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PMT  conclucica  that  a  low  pool  stata  axiata  and  axacutaa  actiona  for  a 
low  pool  atata.  Nota  that  thia  low  pool  atata  ovarrldaa  any  pool 
conditiona  raportad  by  tha  Exacutiva.  Thia  pool  avant  will  cauaa  tha 
ayatam  to  ba  In  a  low  pool  atata  avan  If  tha  Exacutiva  raporta  a  high 
pool  condition. 


13.3.1.5  Largast  Pool  fragnant  Bacomaa  Largar  -  PMT  datacta  that  tha 
aiza  of  the  largaat  pool  fragment  haa  become  larger  than  tha  minimum 
required  fragment  aiza. 

PMT  decidea  that  tha  current  pool  atata  muat  be  baaed  upon  the  lateat 
pool  condition  reported  by  the  Executive.  If  the  Executive  reported  a 
high  pool  condition,  PMT  decidea  that  a  high  pool  atata  exiata.  If 
the  Executive  reported  a  low  pool  condition,  PMT  decidea  that  a  low 
pool  state  exists.  In  either  situation,  PMT  takes  the  appropriate 
action  for  that  state. 


13.3.?  PMT  Default  Actions  for  a  High  Pool  State 

When  PMT  concludes  that  a  high  pool  state  exists,  it  executes  the 
following  actions: 

a   Sets  its  internal  cycle  interval  to  one  minute 

e   Enables  checkpointing  for  itself 

a   Removes  any  pool  use  controls 

PMT  then  stops  itself  so  that  its  impact  on  system  resources  is 
minimized.  PMT  unstops  itself  when  the  internal  cycle  interval  has 
elapsed . 


13.3.3   PMT  Default  Action"  for  a  Low  Pool  State 

When  PMT  concludes  that  a  low  pool   state   exists,   it   executes   the 
following  actions: 

e   Disables  checkpointing  for  Itself. 

e   Sets  its  internal  cycle  interval  to  20  seconds. 

e   Establishes  pool  use  controls  as  follows: 

a.  Prevents  nonprivHeged  users  from  logging  on. 

b.  Suppresses  INSTALL/RUN/REMOVE  sequences  on   nonpr ivileged 
terminals. 

c.  Delays  nonpr  ivileged  task  loading. 

NOTE 

Nonpr  Ivileged  tasks  with  ..  task  priority  less  than 
the  specified  base  priority  cannot  compete  for 
memory  resources  until  a  high  pool  state  exists 
(see  Section  13.4.1).   This  does  net  mean   that 
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•uch  tasks  cannot  b*  requested;  thsy  will  simply 
rsnain  blocked  from  execution  until  PMT  concludes 
that  a  high  pool  state  exists.  All  other  tasks, 
including  any  tasks  already  active  at  the  onset  of 
the  low  pool  state,  are  not  affected  by  this 
control . 

d.  Sends  a  warning  message  to  all  logged  on  terminals  (or 
on-line  terminals  on  systems  without 
multiuser-protection) .  This  message  cannot  be  suppressed 
by  the  NCR  SET  /NOBRO  command  or  the  DCL  SET  TERM 
/NOBROADCAST  command . 

e.  Sends  a  warning  message  to  and  displays  pool  statistics  at 
the  console  terminal. 


13.3.3.1  PMT  Output  to  Terminals  During  Low  Pool  State  -  When  PMT 
determines  that  a  low  pool  state  exists,  PMT  sends  the  following 
varning  message  to  logged  on  terminals  (or  on-line  terminals  on 
systems  without  multiuser  protection) : 

08-AUG-81  13:35:10  —  Low  pool  —  Please  exit  active  tasks  -  ZEPHYR 

The  effectiveness  of  this  message  depends  on  whether  users  exit  from 
their  active  t^sks.  if  they  choose  to  Ignore  this  message,  a  low  pool 
state  continues  to  exist. 

ZEPHYR  is  the  system  name  selected  during  CYSGEN  or  the  DECnet  node 
name  (if  DECnet  is  running  on  your  system). 

PMT  sends  this  message  at  20-second  intervals  until  it  concludes  that 
a  high  pool  state  exists. 


13.3.3.2  PMT  Output  to  the  Console  Terminal  During  Low  Pool  State  - 
In  a  low  pool  state,  PMT  also  sends  a  warning  message  to  and  displays 
pool  statistics  at  the  console  terminal.  The  following  is  an 
annotated  example  of  PMT  output  to  the  console  terminal: 

08-AUG-81  13:35:10  —  Warning  --Pool  is  critically  low  0 
Total  free  pool  >  1116.  bytes  9 
Largest  fragment  -  112.  bytes  0 

In  this  example,  PMT: 

O   Sends  a  warning  message 

0   Displays  the  amount  of  free  pool  existing  at   the   onset   of 
the  low  pool  state 

0   Displays  the  size  of   the   largest   free   fragment   of  pool 
existing  at  the  onset  of  the  low  pool  state 

PMT  broadcasts  this  message  at  20-second  time  intervals  until  it 
concludes  that  a  high  pool  state  exists. 
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13.3.4   PMT  Default  Actions  for  Bxtraa*  Praga«ntation 

Extrva*  f raqmcntation  axlats  whan  the  largest  pool   fragment   is   less 
than  84(10)   bytes.    In   this  case,  pool  is  exhausted  and  it  is  not 

rossible  to  free  any  pool  by  unsolicited  terminal  input,  for   example, 
ssuing   an   ABORT  command.   At  this  point,  PMT  takes  immediate  action 
to  prevent  total  pool  depletion  by  executing  the  following  steps: 

e  Enters  kernel  mode,  which  prevents  any  other  tasks  from 
executing  but  does  allow  the  system  to  respond  to  device 
interrupts. 

e  Prevents  the  invocation  of  TKTN.  (Invoking  TKTN  at  this  time 
depletes  the  available  pool.)  It  does  this  by  clearing  TKTN's 
special  TCB  pointer  that  is  stored  within  the  Executive. 

e  Sends  a  warning  message  to  the  console  terminal. 

e  Prompts  you  to  abort  one  or  more  of  the  tasks  displayed.  (You 
must  be  at  the  console  to  free  pool  in  response  to  the  PHT 
prompts.)  After  you  select  a  task  to  abort,  PMT  returns  to 
usftr  mode  until  the  abort  operation  is  finished. 

e  Displays  a  message  at  the  terminal  running  the  task  and  the 
console  terminal  if  the  task  is  successfully  aborted. 

e  Displays  (upon  request)  an  updated  list  of  abortable  tasks  at 
the  console  terminal. 

(On  R8X-11M  systMiS  84(10)  ^•'*-«s  is  the  siie  of  a  CLI  coanand  buffer.) 


13.3.4.1  Abortable  Tasks  -  The  abortable  task  list  includes  only 
those  tasks  that  PMT  considers  eligible  to  abort.  A  task  is  abortable 
if  it  meets  the  following  requirements: 

e  It  must  be  active. 

e  It  must  be  resident  in  memory. 

e  Tt  cannot  be  privileged  and  running  from  the  console  terminal. 

e  It  cannot  be  a  Command  Line  Interpreter  (CLI)  task. 

e  It  cannot  be  an  Ancillary  Control  processor  (ACP)  task. 

e  It  cannot  be  the  task  loader. 

e  It  cannot  have  any  internal  conditions  that  prevent  it  from 
exiting  upon  an  abort  request  (for  example,  it  is  already 
aborted) . 

The  ability  to  abort  tasks  included  in  this  list  is  a  powerful  feature 
and  one  that  is  potentially  harmful  to  your  system.  You  should  abort 
tasks  that  consume  pool  and  are  relatively  expendable.  This  action 
should  release  pool  resources  for  use  by  the  remaining  active  tasks 
and  allow  the  system  to  continue  operation,  rather  than  deadlock  over 
pool  resources. 
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It  la  Important  that  you  use  diacratlon  whan  aalacting  taaks  to  abort. 
Aborting  cartain  taaka  could  randar  all  or  part  of  tha  application 
unuaabla.  You  can  abort  cartain  tasks,  for  axampla,  PIP  or  MAC,  and 
axparianca  ralativaly  faw  sida  affacts.  As  an  addad  measure  of 
protection  for  your  system,  PMT  does  not,  by  default,  include  in  the 
abortabla  task  list  the  privileged  tasks  running  from  the  console 
terminal.  Therefore,  if  it  is  possible,  you  should  run  the  privileged 
tasks  that  you  do  not  want  considered  abortable  (by  PMT)  from  tha 
console  terminal. 


13.3.4.2  PMT  Massages  -  When  extreme  pool  fragmentation  occurs,  PMT 
displays  a  message  in  the  following  format  and  a  list  of  abortable 
tasks  at  the  console  terminal: 

dd-mmm-yy  hh:mm:ss  —  Warning  —  Free  pool  exhausted 
Abortable  tasks  in  memory; 

tttttt   P   I/O-xxx.    ttnnt 

where: 

tttttt    The  name  of  the  abortable  task 

p        The  indicator  that  the  task  is  privileged  (a  blank  means 
that  it  is  nonpr ivlleged) 

XXX      The  total  outstanding  I/O  count  for   he  task 

ttnn     The  terminal  where  the  task  is  running  from 

PMT  lists  the  tasks  in  order  of  decreasing  priority  but  does  not 
display  the  priority  of  individual  tasks. 

PMT  then  prompts  you  to  select  one  of  the  tasks  from  the  list  as 
follows: 

Enter  a  task  to  abort,  or  press  RETURN  to  exit; 

If  the  task  you  specify  is  not  installed  or  not  on  the  list  of 
abortable  tasks,  PMT  displays  one  of  the  following  messages: 

Task  not  installed,  try  again: 

Task  not  aborted,  try  again; 

PMT  displays  the  list  of  abortable  tasks  if  you  press  LINE  PEED  in 
response  to  either  prompt.  If  you  press  RETURN,  PMT  relinquishes 
control  of  the  system,  by  returning  to  user  mode,  for  at  least  seven 
seconds,  giving  the  system  an  opportunity  to  recover  from  the  low  pool 
state  unassisted. 

If  PMT  is  not  able  to  abort  the  task  you  specify  and  the  task  Is 
listed  as  abortable,  PMT  displays  the  following  message  (this  only 
occurs  if  the  task  exits  before  PMT  is  able  to  abort  it): 

Task  not  aborted,  try  again: 

If  PMT  successfully  aborts  the  task,  it  sends  the  following  message  to 
the  console  terminal: 

"tttttt"  aborted 
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Also,  If  the  tack  was  not  running  from  tha  console  terminal,  PMT 
displays  the  following  messages  at  the  terminal  where  the  task  is 
running  from: 

08-AUG-81  13:35:10  —  Warning  —  Free  pool  exhausted 

■tttttt"  aborted 

PMT  then  sends  the  following  message  to  the  console  terminal: 

press  LINE  FEED  for  an  updated  task  list, 
enter  a  task  to  abort,  or  press  RETURN  to  exit: 


13.3.4.3  Annotated  Example  of  PMT  Output  for  Extreme  fragmentation  - 
An  annotated  example  of  PMT  output  for  extreme  fragmentation  is  shown 
in  Example  13-1.  The  numbers  in  the  example  correspond  to  the 
numbered  items  in  the  list  that  follows  Example  13-1. 

Example  13-1   PMT  Output  for  Extreme  Fragmentation 
8-AU0-81  13:42:23  --  Warnins  --  Free  ^ool  exhausted   Q 
Abortable  task*  in  neiiorw:   ^ 


RHDEHO 

P 

1/0" 

0. 

TTO: 

COT.  .  . 

P 

1/0= 

0. 

TTO: 

AT.T30 

P 

I/O- 

1. 

TT30: 

EDIT14 

1/0= 

1. 

TT14: 

HAIT20 

I/O- 

1  . 

TT20: 

TEST 

I/O- 

0. 

coo: 

PIPT21 

I/O- 

1. 

TT2i: 

MACT47 

I/O- 

1. 

TT47: 

Enter  a  task  to  abortr  or  ^re»s  RETURN  to  exit:  PIPT21 

■PIPT21'  aborted   O 

Press  LINE  FEED  for  an  undated  task  listr 

enter  a  task  to  sbortt  or  press  RETURN  to  exit:  '>\D 

Abortable  tasks  in  aenorw:   A 


RHOENO 

P 

I/O- 

0. 

TTO: 

COT... 

P 

I/O* 

0. 

TTO: 

AT.T30 

P 

I/O- 

1. 

TT30: 

EDIT14 

I/O- 

1. 

TT14: 

HAIT20 

I/O- 

1. 

TT20: 

TEST 

I/O- 

0. 

coo: 

HACT47 

I/O- 

1. 

TT47: 

Enter  a  task  to  abortt  or  press  RETURN  to  exit:  EDT 

Task  not  installed*  trw  asain:  EDIT14   ^ 

'EDIT14*  aborted   ^ 

Press  LINE  FEED  for  an  updated  task  list* 

enter  a  task  to  abort*  or  press  RETURN  to  EXIT:  & 
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In  this  cxMBpl*,  PMTt 


Sends  a  warninq  mcMtiag*  to  logged  on  terminals  (or  on-line 
terminals  if  thh  system  does  not  support  multiuser 
protection)  . 

Displays  the  list  of  abortable  tasks  at  the  console 
terminal . 

Prompts   for   a   task   to   abort    (PIPT21    is  entered)  . 

Aborts   "PIPT21". 

Prompts  I  or  an  updated  task  list,  a  task  to  abort,  or  an 
exit.   (A  LINE  FEED  is  entered  for  an  updated  task  list.) 

Displays  the  list  of  abortable  tasks. 

Prompts  for  a  task  to  abort  (EDT  Is  entered)  . 

Indicates  that  a  task  with  the  name  "EDT"  is  not  installed, 
and  requests  that  you  try  again  (EDIT14  Is  entered) . 

Aborts  "EDIT14". 

Prompts  for  an  updated  task  list,  a  task  to  abort,  or  an 
exit.       (The    RETURN  key   is   pressed    for   an   exit.) 


13.3.5     PMT  Task-Build  Options 

You  can  modify  PMT's  response  to  pool  conditions  by  editing  PMT's 
task-build  file  PMTBLD.CMD  and  re-task-building  PMT.  If  you  wish  to 
modify   PMT,    you  must: 

1.  Remove    PMT    (the    task  name    is    PMT...)    by  using   VMR 

2.  Edit    the   rasR-bulld    file 

3.  Re-task-build    PMT 

4.  Install    the  modified    task    Image  by  using   VMR 

When  the  system  is  rebooted,  the  new  PMT  task  will  begin  executing. 
If,  however,  you  want  the  modified  task  Image  to  run  Immediately,  you 
must  first  abort  PMT  before  you  remove  and  reinstall  it  using  MCR  or 
DCL. 

The   PMT  features   that   you  can  modify  are: 

e      Timing   control 

e      Actions 

e      Pool    use  controls 

The  specifics  of  modifying  PMTBLD.CMD  are  documented  in  the  file 
itself.  Following  is  a  discussion  of  the  PMT  features  that  you  can 
modify. 
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13.3.5.1  Controlling  PMT  Tlninq  -  PMT  basically  operates  in  a  cycle. 
It  btcomas  unstopped  at  regular  intervals  to  monitor  fragmentation  and 
then  stops  itself.  When  the  Executive  interrupts  the  cycle  to  report 
•  new  pool  event,  PMT  resets  the  cycle  to  begin  at  the  point  at  which 
it   was    Interrupted. 

PMT's  cycle  can  have  one  of  two  possible  time  lengths.  The  length 
depends  on  the  current  state  of  pool.  If  a  low  pool  state  exists,  the 
cycle  is  20  seconds  (plus  the  time  PMT  requires  to  execute  all  low 
pool  state  actions).  If  a  high  pool  state  exists,  the  cycle  is  60 
seconds  (plus  the  time  PMT  requires  to  execute  all  high  pool  state 
actions) . 

You  can  modify  PMT's  cycle;  however,  the  only  modification  allowed  is 
to  lengthen  the  high  pool  state  cycle.  The  fiO-second  value  is  not 
only  the  default  value  but  also  the  minimum  value  that  you  can 
specify.  If  you  lengthen  the  cycle,  PMT  may  not  be  as  affective  at 
monitoring  pool  fragmentation  problems.  You  can  partially  compensate 
for  this,  by  using  the  SET  /PLCTL  command  (see  Section  13.4.2)  to 
increase  the  minimum  size  of  the  largest  pool  fragment  parameter. 
This  ensures  that  PMT  will  detect  imminent  pool  fragmentation  problems 
earl ier . 


13.3.5.2  Controlling  PMT  Action  -  You  can  modify  some  of  the  actions 
that    PMT  executes  during    the   cycle.      The   actions  are   as   follows: 

e      Sending    warning   messages   to    logged   on      terminals      (or      nn-line 
terminals  on    systems   that   do   not   support  multiuser    protection) 

e      Forcibly  checkpointing    stopped    tesks    in  memory 

e      Aborting    certain   privileged    tasks 

When   a    low  pool    state   exists,    PMT  sends   warning  messages   to    logged      on 

terminals      (or      on-line      terminals     on      systems  that      do      not   support 

multiuser  protection).  You  can  suppress  this  action  by  modifying 
PMTBLD.CMD  and    re-task-building    PMT. 

When  a  low  pool  state  exists,  PMT  requests  the  Executive  to  forcibly 
checkpoint  all  memory-resident  stopped  tasks  without  outstanding 
nonbuffered  I/O.  These  tasks  include  CLI  tasks,  ACP  tasks,  and  tasks 
with  outstanding  buffered  I/O,  only  if  they  are  stopped  during  a  low 
Jiool  state.  When  the  Executive  checkpoints  a  task,  it  deallocates  the 
task  header,    thereby  reducing    fragmentation. 

You  can  modify  PMTBLD.CMD  to  enable  such  checkpointing  for  a  high  pool 
state  as  well.  This  reduces  the  effect  of  long-term  fragmentation, 
making  it  more  likely  that  a  long-lived  data  structure  will  be 
allocated  to  a  lower  address  within  pool.  This  clusters  the 
long-lived  data  structures  together,  leaving  larger  blocks  of  free 
pool  available  for  more  dynamic  types  of  allocation.  Although  this 
can  increase  the  effective  use  of  available  pool  space,  it  also  causes 
a  noticeable  increase  in  disk  I/O  as  tasks  are  checkpointed .  CLI 
tasks,  ACP  tasks,  and  tasks  with  outstanding  buffered  I/O  are  exempt 
from  checkpointing   while  a   high  pool    state  exists. 
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The  remaining  option  concerns  PMT's  list  of  abortable  tasks.  During 
extreme  fragmentation,  PHT  displays  a  list  of  abortable  tasks  and 
prompts  for  tasks  to  abort.  By  default,  PMT  does  not  list  or  abort 
privileged  tasks  running  from  the  console  terminal.  You  can  override 
this  default  by  modifying  PMTBLD.CMD.  There  are,  however,  exceptions 
to  this  option.  These  exceptions,  CLI  tasks,  ACP  tanks,  and  the  task 
loader,  are  never  listed  by  PMT  as  abortable  tasks. 


13.3.5.3  Controlling  Pool  Use  -  When  a  low  pool  state  is  in  effect, 
PMT  executes  the  default  pool  use  controls  described  in  Section 
13.3.3.  You  can  suppress  any  of  these  controls  by  nodlfylng 
PMTBLD.CMD  and  re-task-bui Idlng  PMT. 


13.3.^;  Aborting  PMT 

If  you  wish  to  terminate  PMT,  you  can  easily  abort  it.    You  must  do 
one  of  the  following  to  abort  PMT: 

e   Issue  an  ABORT  command  from  a  privileged  terminal 

e   Iffsue  an  abort  directive  from  a  privileged  task 

When  you  select  either  of  these  m-Jthods,  PMT  performs   the   following 
actions  before  it  exits: 

e  Restores  TKTN's  special  TCB  pointer  If  PMT  previously  cleared 
the  pointer  and  TKTN  is  still  installed  (see  Section  13.3.4). 
This  restores  normal  TKTN  operations. 

•  Prevents  the  Executive's  pool  monitor  code  from  requesting  PMT 
aftfr  PMT  exits.  This  is  done  by  clearing  the  special  TCB 
pointer  for  PMT...  as  set  by  MCR  INSTALL,  DCL  INSTALL,  and 
VMR  INSTALL  commands. 

•  Cancels  any  outstanding  pool  use  controls  that  it  may  have 
imposed  because  of  a  low  pool  state. 

e   Displays  the  following  message  at  the  console  terminal: 

Remove  and  reinstall  PMT  to  restore  pool  monitoring 

"PMT..."  aborted 

This  indicates  that  PMT's  special  TCB  pointer  has  been  cleared 
so  that  the  Executive  can  no  longer  request  PMT  to  run.  To 
restore  the  pointer,  you  must  remove  and  reinstall  PMT  using 
MCR  or  DCL. 


13.4   THE  SET  /PLCTL  COMMAND 

The  SET  /PLCTL  command  sets  the  pool  limit  parameters  used  by  the 
Executive  pool  monitor  code  and  PMT.  The  syntax,  parameters,  and 
parameter  limits  for  the  command  are  discussed  in  Chapter  10  and  also 
in  the  RSX-llM/M-PLUS  MCR  Operations  Manual.  Basic  guidelines  for 
setting  the  four  command  parameters  are  discussed  in  the  following 
subsections. 
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During  a  low  pool  state,  you  can  compara  the  values  you  set  and  the 
Information  that  is  output  to  the  console  terminal  (see  Section 
13.3.3.2)  to  determine  whether  the  parameters  require  further 
modification. 


13.4.1   Low  and  High  Pool  Limits 

The  first  two  parameters  of  the  SET  /PLCTL  command  establish  the  low 
and  high  pool  limits.  The  Executive  pool  monitor  code  usas  these 
limits  to  determine  when  major  pool  events  occur. 

In  general,  you  should  set  the  low  limit  value  to  the  least  desir.^ble 
pool  level.  This  is  a  limit  where  your  system's  workload  cannot 
increase  without  the  risk  of  a  pool  resource  deadlock.  The 
appropriate  value  for  this  limit  varies  with  each  system.  You  can 
determine  the  best  value  by  experimenting  with  various  limits.  The 
low  limit  defaults  to  fiOO(lO)  bytes. 

Set  the  high  limit  value  to  reflect  the  type  of  use  your  system 
receives.  The  high  limit  parameter  essentially  controls  the  point 
where  a  low  pool  state  is  transformed  into  a  high  pool  state.  The 
high  limit  defaults  to  1600(10)  bytes. 

If  pool  use  fluctuates  conside<^ably ,  a  limit  set  relatively  higher 
than  the  low  limit  will  tend  to  reduce  tl.?  number  of  pool  state 
transitions.  If  pool  use  is  typically  constant,  ."•  high  limit  ?et 
close  to  the  low  limit  will  quickly  show  critical  changes  in  the  pool 
state.  Since  pool  needs  and  use  vary,  you  should  experiment  with  this 
parameter  to  determine  the  optimum  value. 


13.4.2   Pool  Fragment  Size 

This  parameter  establishes  the  minimum  size  of  the  largest  pool 
fragment.  PMT  uses  this  limit  to  determine  when  pool  fragmentation 
problems  exist.  When  the  largest  pool  fragment  is  the  minimum  size  or 
greater,  a  high  pool  state  exists  —  as  far  as  fragmentation  is 
concerned.  A  low  pool  state  exists  when  the  largest  pool  fragment  is 
smaller  than  the  minimum  size.  The  lowest  permissibTs  size  of  the 
largest  pool  fragment  is  200(10)  bytes  by  default.  You  should 
experiment  with  this  parameter  to  judge  the  optimum  value. 

Fragmentation  is  one  of  the  more  frequent  and  less  desirable  pool 
problems.  Thus,  the  value  that  you  specify  for  this  parameter  can 
have  an  immediate  impact  on  successful  pool  monitoring. 


13.4.3   Base  Priority  for  Nonpr ivileged  Tasks 

This  parameter  establishes  the  base  priority  for  nonpr ivileged  tasks. 
The  optimum  value  of  this  parameter  is  application  specific,  but 
defaults  to  51(10).  During  a  low  pool  state,  PMT  uses  this  parameter 
to  restrict  newly  requested  nonpr ivileged  tasks  from  competing  for 
memory  resources  (see  Section  13.3.3).  Only  those  tasks  ',;ith  a 
priority  less  than  the  specified  base  priority  are  so  restricted. 
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CHAPTER  14 
THE  SHUFFLER 


Th«  Shuffler  (SHF)  is  a  privilcqcd  task  designed  to  compact  space  in 
system-controlled  partitions  when  a  memory  allocation  failure  occurs. 
The  Shuffler  operates  only  within  system-controlled  partitions  and  is 
available  for  the  RSX-llM/M-PLUS  operating  systems,  but  is  not 
available  for  unmapped  systems  or  for  RSX-HS. 

This  chapter  describes  Shuffler  interaction  with  the  operating  system. 
Briefly,  it  describes  system-controlled  partitions.  In  more  detail, 
it  describes  Shuffler  structure,  ways  to  monitor  the  Shuffler,  and 
Shuffler  algorithms  for  the  operating  system. 


14.1   EXECUTIVE  AND  MEMORY  USAGE 

Memory  is  the  processor  storage  medium  in  which  the  Executive  and 
tasks  reside  when  executing.  The  Executive  is  the  kernel  of  the 
operating  system  that  interfaces  the  hardware  system  with  other 
components  of  the  operating  system  and  with  the  user. 

The  Executive  brings  a  task  into  memory  for  execution  and  places  the 
task  in  competition  with  other  active  tasks.  When  tasks  are  brought 
into  memory,  they  are  placed  in  a  section  of  memory  called  a 
partition.  Partitions  are  contiguous  areas  of  memory  in  which 
executable  tasks  run;  however,  a  common  partition  may  be  defined  that 
contains  only  data  or  code. 

RSX-11N-PLU8  supports ^only  •yat«B-controll«d  partitions. 

RSX-llM  supports  thrss  typos  of  partitions} 

•  SystoM-controllod  partitions 

a  Usar-controllad  partitions 

a  Comon  partitions 

Usar-controlled  partitions  and  system-controlled  partitions  are  us^d 
to  load  waiting  tasks.  User-controlled  partitions  accommodate  only 
one  task  at  a  tine.  If  you  want  to  run  multiple  tasks  within  a 
usar-controllad  partition,  you  must  define  multiple  subpartitions. 

System-controlled  partitions  accommodate  as  many  tasks  as  possible  at 
any  one  time.  The  Executive  allocates  available  space  in 
system-controlled  partitions  and  creates  the  dynamic  subpartition  for 
each  task. 
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[On  R8X-11M-PLU8,  taska,  d«vlc«  drivara,  dynanlc  coaaon  raglona,  and 
. static  coaaon  r»a<3na  raaida  In  aubpartltlona  of  the  ayataa-controllad 
Itpartitlon.  Static  conaon  ragiona  ara  raaidant  llbrariaa  and  raaidant 
feoaaona  and  both  aay  ba  aharad  by  taaka  for  aora  afficiant  usa  of 
Iphyaical  aaaory.  Raaidant  librariaa  contain  coda,  and  raaidant 
[eoaaona  contain  data. 

On  RSX-llM,  atatic  coaaon  raqiona  auat  ba  loadad  into  coaaon 
partitiona.  A  coaaon  partition  ia  a  dadicatad  araa  of  aaaory  that  aay 
ba  Bharad  by  taaka.  Taaka,  davica  drivara,  and  dynaaic  coaaon  ragiona 
creatad  by  aaaory  managaaant  diractivaa  inuat  ba  loadad  into 
8ubpartil.>.ona  of  tha  ayatea-controllad  partition. 


14.1.1  Syataa-Controllad  Partitiona 

• 
Only  mapped  systems  support  system-controlled  partitions.  A  mapped 
aystem  is  a  system  with  memory  management.  A  task  in  a  mapped  system 
can  run  in  any  system-controlled  partition  large  enough  to  contain  it, 
and  the  Executive  is  responsible  for  allocating  space  In  that 
partition.  Refer  to  the  RSX-llW/M-PLUS  MCR  Operations  Reference 
Manual  for  detailed  information  on  system-controlled  partitions  and 
memory  management. 

The  Executive  allocates  dynamic  memory  space  for  waiting  tasks  in  the 
following  manner: 

1.  Uses  a  priority  level  of  1  through  250  to  determine  a  waiting 
task's  use  of  a  system-controlled  partition.  A  higher  number 
indicates  a  higher  priority. 

2.  Begins  at  the  base  of  the  partition  and  searches  for  a  free, 
contiguous  area  large  enough  for  the  waiting  task. 

3.  Creates  a  dynamic  subpartition  within  the  system-controlled 
partition. 

4.  Eliminates  the  subpartition  to  free  memory  when  the  task  has 
finished  execution. 

In  some  instances,  a  waiting  task  cannot  be  loaded  into  a 
system-controlled  partition  because  there  is  not  enough  memory  space 
available.  If  there  is  not  enough  space  to  load  a  waiting  task,  the 
Executive  uses  checkpointing  to  make  memory  space  available  to  the 
waiting  task. 

To  make  room  for  a  waiting  task,  the  Executive  searches  the 
system-controlled  partitions  for  one  or  more  tasks  with  a  lower 
priority  than  that  of  the  waiting  task.  The  Executive  then 
checkpoints  (moves)  the  task  of  lower  priority  from  memory  to  disk  to 
make  room  for  the  waiting  task  of  higher  priority.  The  checkpointed 
task  is  immediately  pl.":ed  in  competition  with  other  tasks  waiting  for 
residency.  When  the  checkpointed  task  is  reloaded,  it  continues 
processing  from  the  point  where  it  was  interrupted. 

On  RSX-11N-PLU8,  tha  Exacutiva  keeps  track  of  outstanding  I/O  on  a 
partition-by-partition  basis.  Thus,  tha  Exacutiva  may  checkpoint 
subpartitions  with  dynaaic  coaaon  ragions,  static  coaaon  regions,  and 
task  regions  if  there  is  no  I/O  pending. 
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On  RSX-llM,  the  Executive  k««ps  track  of  outstanding  I/O  on  a 
task-by-taak  basla.  Tha  Exacutlva  cannot  aaally  datarmlna  to  which 
partition  outstanding  I/O  Is  dlractad.  Tharafora,  RSX-llM  can  only 
checkpoint  subpartitions  with  task  regions.  Comnon  partitions  and 
dynamic  common  regions  created  by  memory  management  directives  cannot 
be  checkpolnted. 


14.1.2   Partition  Pragmentatlon 

Checkpointing  does  not  always  create  enough  memory  space  to  load  a 
waiting  task.  This  is  a  result  of  partition  fragmentation. 
Fragmentation  in  system-controlled  partitions  occurs  when  tasks  of 
various  sizes  are  entering  and  exiting  memory,  or  when,  for  example, 
device  drivers  are  loaded  in  the  middle  of  a  system-controlled 
partition.  Device  drivers,  which  cannot  be  checkpo inted ,  often  create 
space  between  subpartitions  and  below  subpartitions  called  fragments. 

Tasks  with  nonbuffered,  outstanding  I/O  cause  fragmentation  of 
system-controlled  partitions.  Such  tasks  cannot  be  checkpo Inted .  The 
Executive  muse  wait  for  the  task's  I/O  count  to  reach  zero  beforo  the 
task  can  be  checkpointed .  While  the  Executive  waits  for  the  cask's 
I/O  count  to  reach  zero,  the  task  is  blocked  from  execution  to  prevent 
the  task  from  issuing  more  I/O  requests  that  could  delay  the  loading 
of  the  waiting  task.  The  following  lists  the  serious  causes  of 
fragmentation  in  system-controlled  partitions: 

1.  Device  drive.'"  loaded  in  the  middle  of   a   system-controlled 
partition 

2.  Subpartitions  that  are  connected  to  the  IPll  driver 

3.  Subpartitions  that  are  connected  to  an   interrupt   vector   by 
means  of  a  CINTS  directive 

4.  Subpartitions  with   nonbuffered,   long-outstanding   I/O,   and 
whose  I/O  count  has  not  yet  dropped  to  zero 

5.  Regions  that  have  been  fixed  by  the  Executive   for  a  memory 
parity  error 

6.  Dynamic  regions  created  by  PLAS  directives  (RSX-llM  only) 

If,  for  any  reason,  including  fragmentation,  the  Executive  is  unable 
to  load  a  waiting  task  into  a  subpartition,  the  Executive  requests  the 
Shuffler.  The  Shuffler  moves  subpartitions  in  system-controlled 
partitions  in  an  attempt  to  create  the  free  space  necessary  tc  load  a 
waiting  task.  Thus,  the  Executive  requests  the  Shuffler  only  when  all 
other  attempts  to  load  a  waiting  task  fall. 


14.2   SHUPPLER  PERFORMANCE 

The  Shuffler  is  approximately  700(10)  words  and  can  be  Installed  only 
on  a  mapped  system.  The  Shuffler  Is  Installed  during  system 
generation  by  a  VMR  command  and  by  default  is  built  for  the  partition 
SYSPAR,  which  can  also  be  used  by  the  MCR  dispatcher  and  TKTN.  Refer 
to  the  RSX-llM  or  RSX-llM-PLUS  System  Generation  and  Installation 
Guide  for  more  TTTformation  on  Installing  the  Shuffler. 
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The  overhead  incurred  for  the  Shuffler  task  is  found  in  the  Shuffler, 
not  in  the  Executive.  The  Shuffler  responds  well  on  a  system  if  there 
•re  fewer  tasks  loaded  in  memory  and  if  the  Shuffler  does  not  execute 
frequently.  If  you  have  a  heavily  loaded  system,  the  Shuffler  may 
execute  more  than  you  want  because  of  repeated  memory  allocation 
failures.  If  the  Shuffler  executes  frequently  on  your  system,  better 
performance  is  obtained  when  the  Shuffler  is  fixed  in  its  own 
partition  where  it  does  not  have  to  compete  with  MCR  and  TKTN  for 
memory. 

The  word,  SSHPTM,  in  the  Executive's  system  common  area  limits  the 
number  of  times  the  S'luffler  may  be  requested  within  a  time  interval. 
SSHPTM  heightens  the  Shuffler's  effectiveness  on  your  system.  Each 
time  the  Executive  requests  the  Shuffler,  this  timer  is  checked.  If 
the  timer  registers  zero,  the  Shuffler  may  be  requested.  If  the  timer 
registers  a  positive  number,  the  request  for  the  Shuffler  is  ignored. 
The  amount  of  time  (clock  ticks)  that  must  elapse  before  the  Shuffler 
is  requested  again  i^  stored  in  the  system  common  area,  $SHFCT.  When 
the  Shuffler  is  successfully  requested,  $SHFTM  is  initial .zed  for  the 
new  interval  with  the  value  stored  in  $SHFCT. 

If  you  are  a  privileged  user,  you  may  change  $SHFCT.  To  change 
SSHFCT,  you  need  a  copy  of  RSXll.MAP,  the  Executive  map  produced 
during  system  generation.  Using  the  map,  you  must  determine  the 
address  of  th<a  global  symbol  $SHFCT.  You  can  change  the  contents  of 
the  system  SSHFCT  with  the  MCR  OPEN  command.  The  Shuffler  is 
requested  infrequently  if  the  value  is  set  too  high.  If  the  value  is 
set  too  low  (zero),  system  response  may  decrease  because  the  Shuffler 
is  being  requested  too  frequently. 


14.2.1   Monitoring  The  Shuffler 

Several  memory  allocation  failures  during  peak  usage  periods  result  in 
the  repeated  request  of  the  Shuffler.  The  repeated  execution  of  the 
Shuffler  can  produce  a  noticeable  decrease  in  response  time.  You  may 
monitor  the  Shuffler's  effect  on  your  system  by  using  RMD.  RMD  is  a 
privileged  task  that  displays  information  concerning  task  activity  on 
the  operating  system.  Refer  to  Chapter  6  for  a  detailed  explanation 
of  RMD. 

If  you  want  to  monitor  Shuffler  activity  with  RMD,  you  must  dedicate  a 
video  terminal  on  which  to  run  the  RMD  display.  The  key  features  to 
monitor  on  the  memory  display  page  are  as  follows: 

1.  The  currently  executing  task;  *IDLE*  indicates  that  no  task 
is  executing 

2.  The  number  of  active  tasks  in  memory  and  the  amount  of  memory 
they  occupy,  plus  the  number  of  active  tasks  checkpointed  (on 
disk)  and  the  total  memory  they  would  require. 

These  features  show  task  activity.  If  the  Shuffler  is  active,  tasks 
are  moving  down  in  the  partition,  and  the  currently  executing  task 
field  registers  the  Shuffler  as  the  active  task. 

Occasionally,  the  Shuffler  registers  as  the  active  task,  but  tasks 
cannot  be  seen  moving  down  in  the  partition.  To  verify  that  tasks  are 
not  moving  when  the  Shuffler  is  executing,  check  the  number  of  active 
tasks  checkpointed  (on  disk)  and  the  number  of  tasks  waiting  for 
memory.  If  this  count  remains  the  same  over  a  period  of  time,  the 
Shuffler  is  executing  but  cannot  create  enough  space  for  waiting 
tasks.  Thus,  the  Shuffler  is  using  too  much  of  the  system's 
resources.  If  the  system  does  not  recover,  it  might  be  better  to 
abort  the  Shuffler  from  your  system. 
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If  the  Shuffler  task  continues  to  use  too  much  of  the  system's 
resources,  you  should  remove  the  Shuffler  from  your  system  with  the 
MCR  REMOVE  command. 


14.3   THE  SHUPPLER  ALGORITHMS 

When  a  memory  allocation  failure  occurs,  the  Executive  requests  the 
Shuffler.  The  Shuffler  searches  memory  for  a  system-controlled 
partition  that  has  at  least  one  task  waiting  for  space.  When  the 
Shuffler  locates  such  a  system-cortrolled  partition.  It  attempts  to 
move  (shuffle)  subpartitions  in  the  memory  partition  to  create  the 
continuous  area  necessary  to  load  waiting  tasks. 

On  RSX-llM,  the  Shuffler  can  only  shuffle  task  subpartitions.   Because 

RSX-llM   does   not   maintain  an    outstanding    I/O  count  on  a 

partition-by-partition  basis,  the  Shuffler  cannot  determine  whether 

outstanding   I/O   is  pending  to  a  common  partition  or  a  dynamic  common 

region.   Thus,  the  Shuffler  does  not   shuffle  common   partitions  or 

subpartitions  with  dynamic  common  regions  created  by  memory  management 
directives. 

On  R8X-11M-PLUS,  the  Shuffler  does  shuffle  common  regions  because  an 
outstanding  I/O  count  is  maintained  on  a  partition-by-partitlon  basis. 
Thus  subpartitions  containing  static  connon  regions  or  dynamic  common 
regions  can  be  shuffled  when  there  is  no  I/O  pending. 

The  Shuffler  uses  two  algorithms  to  move  subpartitions  in  memory. 
Each  algorithm  executes  several  steps  repeatedly  until  the  partition 
reaches  a  stable  state. 


14.3.1   The  Plrst  Pass  Algorithm 

In  the  first  pass,  the  Shuffler  attempts  to  move  each  subpartition  to 
the  base  of  the  partition.  When  subpartitions  are  moved  to  the  base 
of  the  partition,  free  space  is  created  at  the  top  of  the  partition  so 
that  a  waiting  task  can  enter  memory  if  there  is  enough  space. 
Shuffling  occurs  in  the  following  steps: 

1.  The  Shuffler  requests  the  Executive  to  unconditionally 
checkpoint  all  stopped  checkpointable  subpartitions  and 
checkpointable  subpartitions  that  have  been  blocked  with  a 
CLI  command. 

2.  The  Shuffler  attempts  to  move  each  subpartition  to  the  base 
of  the  partition  and  blocks  each  executable  task  from  further 
execution.  If  a  subpartition  has  outstanding  I/O,  the 
Shuffler  waits  for  the  task's  nonbuf fered ,  outstanding  I/O 
count  to  reach  zero.  If  the  I/O  count  does  not  reach  zero  in 
approximately  .5  seconds,  the  Shuffler  marks  the  subpartition 
as  having  outstanding  I/O,  and  restarts  the  first  pass 
algorithm.  The  Executive  clears  the  subpartition's  I/O 
indicator  when  the  task's  I/O  count  becomes  zero. 

3.  The  Shuffler  moves  each  task  to  the  base  of  the  partition. 
If  the  subpartition's  I/O  count  reaches  zero  within  30 
seconds. 

4.  Each  subpartition  is  unblocked  to  allow  further  execution 
after  shuffling  is  complete,  and  the  free  space,  now  above 
the  subpartition,  is  deallocated. 
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Ba  awar*  that  a  flxad  task  can  be  shuffled.   If  you  do   not  want   to 

hav«   a   fixed   task   shuffled,   you  must   fix  this  task   in  a 

user-controlled  partition  or  in  its  own  dedicated  system-controlled 
partition. 

If  fragmentation  has  not  occurred  at  the  end  of  the  first  pass,  the 
Shuffler  has  successfully  merged,  the  free  space  In  the  partition  into 
one  continuous  area  at  the  top  of  the  system-controlled  partition.  A 
task  may  be  loaded  into  memory  if  there  is  enough  available  space. 

Memory  space  may  not  be  available  if  there  are  several  tasks  already 
loaded  in  memory,  or  if  fragmentation  is  dividing  the 
system-controlled  partition  into  two  or  more  partition  sections. 

A  partition  section  is  a  subset  of  the  area  in  a  system-controlled 
partition.  Each  partition  section  is  flanked  on  at  least  one  side  by 
a  subpartition  that  cannot  be  shuffled.  Por  example,  if  a  device 
driver  is  loaded  in  the  middle  of  a  system-controlled  partition,  the 
system-controlled  partition  is  divided  into  two  partition  sections 
because  a  device  driver  is  a  subpartition  that  cannot  be  moved. 

If  during  the  first  pass  algorithm,  the  Shuffler  encounters  a 
subpartition  that  cannot  be  moved,  the  Shuffler  begins  to  shuffle 
subpartitions  that  can  be  moved  to  the  base  of  the  partition  section 
that  bounds  it.  The  Shuffler  cannot  shuffle  subpartitions  around  a 
subpartition  that  cannot  be  moved.  Therefore,  if  fragmentation  has 
occurred  during  the  first  pass,  the  system-controlled  partition  is 
divided  into  two  oi  more  partition  sections,  and  the  free  space  in  the 
partition  may  no  longer  be  merged  at  the  top  of  the  partition,  but 
rather  at  the  top  of  the  partition  section. 

The  Shuffler  initializes  the  second  pass  algorithm  if  enough  memory 
space  is  not  available  for  waiting  tasks,  or  if  fragmentation  has 
divided  the  system-controlled  partition  into  several  partition 
sections.  Little  memory  space  or  partition  sections  prevent  the 
Shuffler  from  accumulating  all  the  free  space  at  the  top  of  the 
partition.  The  free  space  in  each  partition  section  is  separate  and 
cannot  be  merged  with  the  free  space  in  another  partition  section. 


14.3.2  Second  Pass  Algorichm 

The  second  pass  algorithm  is  executed  once  for  each  partition  section 
within  a  system-controlled  partition.  This  pass  attempts  to  create  a 
reverse  priority  list  o*'  subpartitions  that  can  be  checkpointed  by  the 
waiting  task.  During  the  second  pass,  the  Shuffler  creates  a  list  in 
ascending  priority  order  of  the  subpartitions  in  each  partition 
section.  The  Shuffler  then  compares  the  size  of  the  waiting  task  with 
the  sum  of  free  space  in  the  partition  section  plus  the  total  of  one 
or  more  lower  priority,  checkpointable  tasks.  If  the  waiting  task  Is 
snaller,  the  Shufflar  requests  the  Executive  to  checkpoint  the  lower 
priority  task(s)  . 

Checkpolntinc  :.2  lower  priority  tisk(s)  may  create  new  space,  but  the 
new  space  may  ot  comprise  a  continuo'is  area  in  merory.  The  Executive 
may  begin  the  first  pass  alogorithm  to  accumulate  the  free  space  of 
the  partition  section.  The  free  space  is  then  allocated  to  the 
waiting  task.  As  long  as  there  are  subpartitions  that  cannot  be  moved 
In  a  system-controlied  partition,  memory  Is  still  divided  Into  two  or 
more  partition  sections. 
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If  th«  Shuffl<*r  completes  the  second  pass  without  flndlrij  room  for  a 
waiting  task,  the  Shuffler  searches  for  the  next  system-controlled 
partition  with  waiting  tasks.  If  there  are  no  other  syitem-control led 
partitions  with  tasks  waiting  for  memory  speco,  the  Shuffler  exits. 


• 
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CHAPTKR  15 
RSX-llM-PLUS  SYSTEM  RECONFIGURATION 


A  reconf iqurable  system  Is  a  system  in  which  you  can  add  or  remove 
system  resources  such  as  memory  and  devices.  Reconfiguration  is  a 
means  of  physically  and  logically  connecting  and  disconnecting  various 
resources.  This  chapter  discusses  the  purpose  and  application  of 
reconfiguration,  and  describes  the  components  and  'Commands  of  the 
reconfiguration  services. 

System  reconfiguration  is   available   only  on   RSX-llM-PLUS   systems. 

Some  of  tho  information  in  this  chapter,  ho',.?ver,  appliofi  only  to 
multiprocessor  systems.  Blue  ink  is  used  to  distinguish  this 
inf ormat  ion. 


15.1   THE  RECONFIGURATION  SERVICES 

The  reconfiguration  services  allow  you  to  reconfigure  an  RSX-llM-PLUS 
system  to  bypass  faulty  hardware  elements  and  to  isolate  the  system 
from  the  effects  of  these  elements. 

With  the  reconfiguration  services,  you  can  define  a  set  of  hardware 
resources  that  are  accessible  from  the  on-line  system  and  also  remove 
devices  from  the  pool  of  resources  allocated  to  the  on-line  system. 
For  example,  after  booting  the  system,  you  can  place  a  failed  disk 
drive  off  line  and  then  use  anocher  drive  that  is  already  on  line  or 
place  one  on  line  to  take  over  for  the  disabled  unit. 


15.1.1  Reconfiguration  Components  (CON,RD: ,HRC) 


1 


You  reconfigure  system  resources  by  using  together  a  command  interface 
(CON),  a  loadable  driver  (RD:),  and  a  privileged  reconfiguration  task 
(HRC)  .  HRC  and  CON  must  have  enough  chec^'point  space  allocated  for 
them  both  to  be  resident  in  memory  at  the  same  time.  If  the  operating 
system  cannot  load  both  tasks  at  the  same  time,  CON  commands  will 
fail. 

CON,  as  the  command  interface,  receives  and  parses  the  commands  that 
you  issue  to  reconfigure  the  current  system.  CON  then  creates  and 
submits  QIO  packets  to  the  reconfiguration  driver  (RD:). 


1.  DIGITAL  will  accept  SPRs  regarding  the  interface  but   reserves   the 
right  to  treat  such  SPRs  as  informational  only. 
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RDt ,  the  raconf Iguratlon  driver,  serves  as  an  interface  between  a  user 
task  (either  CON  or  a  user  application  task)  and  the  HRC  task;  it  is 
the  gateway  between  tasks  that  generate  reconfiguration  requests  and 
the  dctual  implementation  of  those  requests.  RDt  accepts  QIO  packets 
from  any  task  and  places  these  packets  into  the  receive  queue  of  HRC.i 
Before  passing  the  QIO  packets  to  HRC,  RT:  performs  privilege  and 
address  boundary  checks  on  them.  The  checks  ensure  that  the  packets 
are  using  valid  addresses  and  legal  function  codes,  and,  for  some 
functions,  that  RD:   is  attached  to  them. 

HRC,  the  privileged  reconfiguration  task,  performs  the  actual 
reconfiguration  operations  for  the  system.  To  process  reconfiguration 
requests,  HRC  calls  Executive  routines,  which  then  call  the  associated 
device  drivers.  HRC  services  the  requests  for  configuration 
information  by  passing  the  desired  information  directly  to  the  user 
buffer. 

After  HRC  services  the  request,  a  status  is  returned  (by  means  of  I/O 
completion)  to  the  requesting  task.  The  status  return  was  implemented 
in  part  to  allow  tasks  other  than  CON  to  interface  with  HRC. 

The  data  base  for   each  system   device   contains   status   words   that 

reflect   device   state.  When   you   change  a  system  device  state,  HRC 

modifies  the  appropriate  data  base  status  word  to  either  grant  or 
inhibit  device  access. 


15.1.2   Device  States 

The   RSX-llM-PLUS   system    reconfiguration    services   control  the 

configuration  state  (on  line  or  off  line)  of  the  hardware  devices,  and 

therefore  control  device  access.   A  system  device  can   assume   one  of 
four  states: 

•  On  line  -  device  on  line,  access  granted 

•  Off  line  -  device  off  line,  access  denied 


Marked  for  on  line  -  device   will 
access  path  exists,  access  denied 


be   brought   on   line   when 


•  Marked  for  off  line  -  indeterminate  state,  access  denied 

In  the  on-line  state,  a  device  is  logically  on  line  for  access.  This 
state  indicates  that  an  access  path  exists  between  the  device  and  an 
on-line  processor  and  that  a  call  (if  any)  to  the  driver's  controller 
or  unit  status  change  entry  points  was  successful.  RSX-llM-PLUS 
grants  access  to  on-line  devices  only.  To  access  an  on-line  disk  or 
tape   volume   and   perform   virtual   I/O  on  it  (for  example,  reads  or 


1.  Note  that  programs  written  to  use  the  current  version  of  RD:  may 
have  to  be  modified  in  the  next  release.  You  should  centralize  all 
code  concerning  RD:   so  that  modifications  can  be  made  easily. 

Because  of  the  likely  changes,  RD:  has  not  been  documented.  For  some 
information,  check  the  reconfiguration  sources  located  in  UFD  [27, ^G] 
of  the  distribution  kit  (except  the  RL02  kit,  which  does  not  contain 
any  sources) .  Important  modules  for  the  interface  are  CNHRC,  HROOT, 
and  HRSUB.  (See  also  the  macro  OLRDF$  in  [ 1 , 1] EXEMC.MLB  for  a 
description  of  volume  access  rights  and  mounted  volumes.) 
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writes  to  files),  the  volume  must  be  mounted.  (See  the  RSX-llM/M-PLUS 
MCR  Operations  Manual  or  the  RSX- IIM/M-PLUS  Command  Language  Manual 
Tor  1^   description"  if  volume  access  rights  and  mounted  volumes.) 

When  a  device  >  in  the  ofC-line  state,  the  system  denies  access  to 
the  device.  At-.tempts  to  access  an  off-line  device  result  In  an  I/O 
error  (lE.OFL).  (Sec  the  IAS/RSX-11  I/O  Operations  Reference  Manual 
for  lists  and  explanations  of  error  codes. )  Taking  a  controller  off 
line  also  takes  all  of  its  associated  units  off  line,  which  places  the 
units  in  the  marked  for  on-line  state. 

The  marked  for  on-line  state  Indicates  that  a  request  to  bring  a 
device  or  controller  on  line  has  been  made,  but  part  of  the  access 
path  to  the  device  or  controller  is  off  line.  Access  attempts  yield 
the  error  code  lE.OFL.  HRC  places  a  device  marked  for  on  line 
logically  on  line  when  it  brings  the  entire  access  path  on  line. 

The  marked  for  off-line  state  indicates  that  the  system  encountered  an 
unexpected  error  in  attempting  to  place  a  specific  device  logically  on 
line.  You  must  issue  an  explicit  off-line  command  before  attempting 
or  retrying  an  on-line  operation. 


15.1.3   Placing  Devices  Logically  On  Line  and  Off  Line 

To  place  a  device  logically  on  line,  HRC  first  verifies  that  the 
device  driver  is  loaded  (for  loadable  drivers  only)  and  then  tests 
whether  the  controller  can  access  the  device  (the  controller  must  be 
on  line).  If  the  controller  can  access  the  device  (an  access  path 
exists),  HRC  modifies  the  appropriate  status  word  to  reflect  that  the 
device  is  on  line.  If  the  controller  or  device  cannot  be  accessed, 
HRC  marks  the  device  for  on  line  and  then  places  the  device  on  line 
when  the  access  path  is  brought  on  line. 

Before  placing  a  device  off  line,  HRC  attempts  to  protect  against 
inadvertent  loss  or  possible  corruption  of  data  by  verifying  that  the 
state  change  will  not  interfere  with  active  I/O.  HRC  considers  a 
device  active  and  rejects  off-line  commands  if  the  device  has  context. 
The  reconfiguration  services  define  device  context  as  a  condition  that 
indicates  (or  permits)  I/O  activity  on  the  device.  The  following  is  a 
list  of  conditions  that  define  device  context: 

1.   A  task  is  attached  to  the   device   (for   example,   the   print 
despooler  attaches  the  line  printer). 

?.   The  device  (or  an  associated  device)  is  a  logged-in  terminal. 

3.  The  device  (or   an   associated   device)   contains   a   mounted 
volume. 

4.  For  the  DT07  bus  switch,  a  port  is  logically  connected   to   a 
processor  (linked). 

5.  For  memory  boxes,  the  memory  within  f"   box  is   logically   on 
line  (multiprocessor  systems  only). 

You  cannot  take  a  controller  off  line  if  any  of  the  units  on  the 
controller  have  context. 

For  dual-port  disks  (RK06/07,  RM02/03/05/80/RP07,  and  RP04/05/06) , 
which  have  each  port  connected  to  a  different  controller,  you  can 
place  off  line  one  path  with  context  as  long  as  the  alternate  path  is 
on  line.  (See  the  description  of  the  OFFLINE  command  for  more 
information. ) 
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15.2   INITIATING  THE  RECONFIGURATION  SERVICES 

You  reconfigure  an  RSX-IIM-PLUS  system  interactively  from  a  terminal 
or  by  means  of  indirect  command  files.  The  reconfiguration  services 
act  as  an  interface  between  your  terminal  and  the  RSX-llM-PLUS  system. 

To  issue  a  reconfiguration  command,  type  a  command  line  in  response  to 
the  default  prompt  (>)  or  to  the  explicit  command  interface  prompt 
(CON>) .  A  command  line  consists  of  three  components:  a  command  name, 
any  required  parameters,  and  a  line  terminator.  (Note  that  there  is 
no  DCL  command  to  access  CON.) 


15.2.1   Invoking  CON 

It  is  not  necessary  to  use  the  entire  command  name  when  issuing  a 
command  Tine;  CON  requires  only  the  first  three  characters  of  the 
name.  However,  to  make  the  intent  of  the  command  input  clear  to 
someone  reading  a  printed  copy,  you  can  use  the  entire  command  name. 
For  example,  you  can  issue  the  ONLINE  command  as  follows: 

CON>ONL  dev-spec«T) 
or 

CON>ONLINE   dev-speCKtt) 
dev-spec 

The   target   device. 

m 

The  RETURN  key  (the  line  terminator). 

A  space  or  tab  signals  the  end  of  the  command  name.  Therefore,  no 
spaces  or  tabs  are  permitted  within  the  name  itself.  To  use  the 
reconfiguration  services,  first  invoke  the  command  interface  CON  and 
then  issue  the  commands.  There  are  two  ways  to  invoke  CON 
interactively: 

1.  Use  the   1-line   format   to   invoke   CON,   execute   a   single 
command,  and  return  control  to  MCR.   For  example: 

MCR>CON  command-line 'RET) 

2.  Use  the  direct  task  format  to  invoke  CON  and   obtain   a   task 
prompt  (CON>) .   For  example: 

MCR>CON'Rfl) 
CON> 

Type  CTRL/Z  to  exit  from  the  direct  task  format. 

You  can  also  enter  commands  through  indirect  command  files.  An 
indirect  command  file  that  contains  reconfiguration  commands  does  not 
require  terminal  interaction  when  the  file  is  executed.  Thus, 
indirect  command  files  are  a  convenient  means  of  creating 
configuration  command  sequences  that  create  different  configurations 
or  restore  previous  configurations. 


15--4 


RSX-llM-PLUS  SYSTEM  RECONFIGURATION 

For  example: 

MCR>CON  PCONFIG'IWT' 

This  command  line  Invokes  CON,  executes  the  reconfiguration  commands 
contained  in  the  indirect  command  file  CONFIG.CMD,  and  returns  control 
to  MCR. 

The  command  line 

CON>PCONFIG  fltfl 

executes  the  commands  in  the  file  CONFIG.CMD  and  returns  control  to 
CON, 

Indirect  command  files  can  be  nested  to  a   maximum  depth  of  three. 


15.3   CON  COMMAND  SUMMARY 

Table  15-1  summarizes  the  reconfiguration  commands  and  provides  a 
compact  overview  of  the  commands.  Detailed  command  descriptions 
appear  in  alphabetical  order  in  Section  15.4. 


Table  15-1 
CON  Command  Summar/ 


BUILD 

Creates  a  command  sequence  in  an  internal 
buffer   that,  if  executed,  duplicates  the 
current  system  configuration. 

CLEAR 

Erases  the  command   sequence   created   by 
BUILD   (but  not  the  file  created  by  LIST) 
that  is  stored  in  the  internal  buffer   by 
CON. 

DISPLAY 

Displays  the  configuration  and  status   of 
the    hardware   devices   in   the   current 
system. 

ESTATUS 

Emits  the  current  status  of   a   specific 
device. 

HELP 

Displays  the  help  text  for  CON. 

IDENT 

Displays  the  current  versions  of  CON   and 
HRC   and   the  date  and  time  the  two  tasks 
were  built. 

LINK 

Logically  connects  a  port  of   a   switched 
bus  run  to  a  processor. 

LIST 

Displays  the  results  from  a  BUILD  command 
or   puts   the   command   sequence   into   a 

specified  file.   A  file  type  of   .CMD   is 
suggested   because   that   is   the  default 
type  for  an  indirect  command  file. 

(continued  on  next  page) 
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Table  15-1  (Cont.) 
CON  Command  Summary 


OFFLINE 

Removes  a  device  without  context  from  the 
active   set   of   devices   in   the  current 
configuration. 

OFFLINE  MKMORY 

(Mul  t.  iproroRsor   systems   )nly.)   Romovosj 
the  memory  box  with  the  highest,  addressee 
from  the   system.    Note   that   you  must 
first   ensure   that   nothing  Is  usilnq  the 
memory  in  the  memory  box. 

ONLINE 

Attempts  to  place  a  device   logically   on 
line. 

ONLINE  MEMORY 

(Multiprocessor   systems  only.)  Mds      o 
memory  box  to  the  on-line  configuration. 
Note  that  you  must  expand   the   pjrtltion 

striK-turo  In  ii'-.o  the  T,i'l  1 1  i  on,i  1  momorv. 

SET 

Alters   the   GSR  or    interrupt 
address   values   of   a   device   ani,   on 
niul  t  i  procetisor   system:-;,    .i^;t.i  vatcr.   or 
Inhlbitn  the  sanity  timer  and  Its  alarm. 

SWITCH 

(Multiprocessor  systems  only.)   Logically 
disconnects   a  port  of  a  swltclied  bus  run 
from  a    processor  and   then   conntrts   the 
port   to   another  processor.   The  command 
is  equivalent  tc  a  LINK  command   followed 
by  an  UNI.TNK  command. 

UNLINK 

Logically   disconnects   a    port    of    a 
switched   bus   run   from   Its   respective 
processor. 

• 


CON  also  accepts  two  switches,  /HE  and   /NOMSG.    These  switches  r.re 
used  alone  in  the  CON  commai^d  line.   Their  functions  are  as  follows: 


/HE 
/NOMSG 


Displays  the  help  text  for  CON. 

Suppresses  all  informatio.  displays  and 
error  messages  returned  by  CON.  You  must 
exit  from  and  then  reenter  CON  to  have  the 
messages  be  displayed  again. 
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BUI 


15.4   CON  COMMAND  DESCRIPTIONS 

This  section  describes  eacn  of  the  reconf  irjiirat  ion  commands.  Note 
that  £ome  of  the  commandr;  m'-st  be  issuod  from  a  privileged  terminal. 

BUILD 

The  BUILD  command  creates  a  sequence  of  c>->mmatidn  that,  when  executed, 
duplicates  the  current  system  conf igirat ion.  The  sequence  of 
reconfiguration  v,ommands  resulting  from  a  LUILD  command  is  held  in  a 
buffer  in  memory.  When  this  sequence  of  commands  executes,  the 
reconfiguration  commands  restore  the  system  to  the  exact  state 
existing  when  the  BUILD  command  was  issued. 

Format 

CON>BUI [LD] 

Example 

CON>BUILD 

This  command  creates  a  sequence  of  commands  that   duplicates   the 
current  system  configuration. 


• 
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CLEAR 


CLEAR 

The  JLEAR  command  erases  from  the  internal  buffer  the  current  sequence 

of  commands  created  by  the  BUILD  command.  The  command  does  not  delete 

the  file  created   by  the   LIST  commar.d  (described   later   in   this 
section) . 

Format 

CON>CLEAR  .  • 


Example 


CON>BUILD 
CON>CLEAR 


The  CLEAR  command  removes  from  the  internal   buffer 
sequence  resulting  from  the  previous  BUILD  command. 


the   command 
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DIS 


DISPLAY 

The  DISPLAY  command  provides  current  system  configuration  information 
about  the  device  units,  device  controllers,  processors,  memory  boxes, 
and  memory  box  controllers. 

Format 

CON>DIS[PLAY]  [keyword (s)]  [FOR  string] 
Keywords 

UNI[TS] 

Displays  every  device  unit  in  the  current  configuration. 
The  display  equates  each  device  unit  with  its  respective 
controller . 

CON[TROLLERS] 

Displays  every  device  controller  in  the  current 
configuration. 


FUL[L] 


Displays  the  status  flags  for  every  device  unit  and  device 
controller  in  the  current  configuration.  The  status  flags 
indicate  the  following: 

Accpath      The  device  has  an  on-line  access  path. 

Context  For  a  tape  or  disk  (mountable  device),  the 
device  contains  a  mounted  volume.  For  a 
terminal,  a  user  is  logged  in.  Other  devices 
are  attached. 

Driver  For  a  device  unit,  the  driver  is  loaded.  For  a 
device  controller,  a  driver  is  available. 

Massbus  The  device  is  connected  to  an  RH  MASSBUS 
controller . 

Kultiport  The  device  is  dual-ported  (a  dual-access 
device)  between  two  controllers  (for  example,  a 
dual-ported  RP06  drive) . 

Offline      The  device  is  off  line. 

Online       The  device  is  on  line  (or  marked  for  on  line). 

Prv-Diag  (Used  with  the  OFFLINE  and  ONLINE  keywords.) 
The  device  is  marked  for  on  line  or  off  line, 
but  nothing  can  happen  until  the  respective 
controller  is  brought  on  line  or  taken  off 
line. 

Unknown  The  GSR  assignment  for  the  device  is  160000  and 
thus  cannot  be  accessed. 
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DIS  (Cont.) 


ALL 


Same  display  as  for  the  FULL  keyword  with  the  addition  of 
interrupt  vector  addresses  and  CSR  assignments  for  device 
controllers. 

ATT[RIBUTES] 

Displays  interrupt  vector  addresses  and  CSR  assignments  for 
device  controllers. 

The  DISPLAY  command  allows  more  than  one  keyword  per  command 
line.  However,  some  combinations  (such  as  DISPLAY  UNITS  FULL  FOR 
DB)  are  meaningless.  The  DISPLAY  command  ignores  an 
inappropriate  keyword. 

If  the  command  omits  a  keyword,  the  display  contains  the  logical 
names  and  status  flags  for  every  device  unit  and  device 
controller  in  the  current  configuration. 


FOR  string 


An  optional  parameter  that  allows  a  selective  display  of  a 
particular  device  or  device  group.  When  you  use  this  parameter, 
CON  displays  the  requested  information  for  the  devices  specified 
in  the  string. 

You  can  also  use  one  or  two  wildcard  characters  {*)  in  the 
string.  You  uc<;  one  wildcard  to  find  out  which  devices  are 
connected  to  the  controller  you  have  specified  after  the 
wildcard.  You  use  two  wildcards  to  find  out  which  devices  have 
the  attribute  vou  have  specified  after  the  wildcards  (either 
ONLINE  or  OFFLINE) . 

For  example : 

CON>DIS  FULL  FOR  RH 

This  command  displays  all  of  the  RH  controllers. 

CON>DIS  FULL  FOR  **ONL 

This  command  checks  to  see  which  devices  have  the  ONLINE 
attribute  (port-specific  status  is  not  displayed) . 


Examples 


CON>DISPLAY  FULL  FOR  DB 

DBO:    Of fl ine,Multiport,Massbus,Accpath, Driver 
PORT  DBOA  RHBO:         Online 
PORT  DBOB  RHCO:        Onl ine , Current .Accpath 

DBl:     Of f line, Mult i port, Ma ssbus,Accpath, Driver 
PORT  DBIA  RHBl:         Online 
PORT  DBIB  RHCl:        Onl ine , Cur  rent ,Accpath 

".-.is  command  displays   information   about   all   of   the   DB:-type 
devices  configured  into  the  system. 
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DIS  (Cont.) 


CON>DISPLAY  UNITS 

DBO 

:     RHBO:,RHCO 

DBl 

:     RHB1:,RHC1 

DRO 

:     RHAO: 

DRl 

:     RHAl! 

MMO 

:     RHDO  0: 

MMl 

:     RHD1~1: 

COO 

TTO 

:     YLAO: 

TTl 

:     YZAO: 

TT2 

!     YZAl: 

TT3 

:     YZA2: 

VTO 

DKO 

DKAO: 

DKl 

DKAl: 

DLO 

DLAO: 

LPO: 

LPAO: 

LPBO: 

L»-2i 

LPCO: 

iihO: 

DM0: 

DMAO: 

DM1: 

DMAl: 

This  command  displays  all  of  the  device 
configured  into  the  system. 


units  and   controllers 
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ESTAT 


ESTATUS 

The  ESTATUS  command  causes  CON  to  exit  with  its  exit  status  word 
reflecting  the  current  status  of  a  specified  device.  Used  with  the 
Indirect  Command  Processor  (Indirect;  see  the  RSX-llM/M-PLUS  MCR 
Operations  Manual) ,  the  command  returns  a  16-bit  word  describing 
device  status.  You  can  use  the  status  word  to  obtain  information 
about  the  configuration.  The  meanings  of  the  bits  in  the  word  are 
given  in  Table  15-2.  Note  that  the  meanings  for  units  and  controllers 
are  different  from  those  for  ports. 


Table  15-2 
Exit  Status  Values  for  CON  ESTATUS 


If  th 

e  status  is  for  a  unit  or  controller: 

Bit 

Bit 

No. 

Value 

Description 

Display 

0 

1 

Exit  status  value: 

1 

2 

0  =  Warning 

2 

4 

1  =  Success 

2  =  Error 

4  =  Severe  error 

6 

100 

This  is  a  subcontroller  device. 

7 

200 

This  device  is  a  controller. 

8 

400 

0-device  is  on  line,  1-device  Is 

Online 

off  line. 

Offline 

9 

1000 

Device  is  restricted  to  privileged 

F  _Diag 

and  diagnostic  functions. 

10 

2000 

This  is  a  multiport  device. 

Multiport 

11 

4000 

This  is  a  MASSBUS  device. 

Massbus 

12 

10000 

This  device's  CSR  is  160000 
(unknown) . 

Unknown 

13 

20000 

This  device  has  an  on-line  access 
path. 

Accpath 

14 

40000 

This  device  has  context. 

Context 

15 

100000 

A  driver  is  loaded  for  this  device. 

Driver 

If  th 

e  request 

is  for  a  port: 

Bit 

Bit 

No. 

Value 

Description 

Display 

0 

1 

Exit  status  vaiue  (see  above) 

1 

2 

2 

4 

8 

400 

0-port  on  line,  1-port  off  line. 

Onl ine 
Offline 

10 

2000 

This  is  the  current  port. 

Current 

13 

20000 

There  is  an  on-line  access  path  to 
this  port. 

Accpath 

14 

40000 

This  port  or  the  device  it  services 
has  context. 

Context 
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Example 


ESTAT  (Cont.) 


>«TI  : 

AT. >.  ENABLE    SUBSTITUT  10,>i 

AT.>rON    F?TAT    DBl: 

>CON    ESTAT   DBl: 

AT.>; '<KySTAT>' 

>;126401 

AT.>    :■ 

>e    <EOF> 

> 


!  Invoke    Indirect. 

!  Enable    substitution   mode. 

!  Type    CON   command    line. 

!  System   displays   command    line. 

1  Request    contents   of    <EXSTAT>    to    be   displayed. 

!  System   displays    current    <EXSTAT>    contents, 

1  Exit    Indirect 


Using  Indirect  interactively,  the  COK  command  line  emits  the 
current  status  of  DBl:,  which  is  stored  in  the  Indirect  special 
symbol    <EXSTAT>. 

The    number    126401   ha=    the    following    meaning: 

100000  Device's   driver    loaded. 

20000  Device   has   on-line    access   path. 

6000  Device    is   both   multiport;   and    MASSBUS. 

40C  Device    is   off    line. 

1  Exit    status    value   =    Success. 
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HE 


HELP 

The  HELP  command  displays  the  help  text  for  CON. 

Format 

CON>HE[LP] 
Example 

C0N>nE;.r 

CON  —  Configuration  Control  Command  Task 
Implemented  commands: 

ONLINE  <device_list> 

ONLINE  MEMORY  <memory  box> 

ONLINE  ALL 

OFFLINE  <device_list> 

OFFLINE  MEMORY  <memory  box> 

OFFLINE  A'.L 

SET  <controller_sp 

(User  typed  CTRL/0  to  suppress  further  output.) 
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IDENT 


IDENT 

The  IDENT  command  displays  the  current  version  numbers  of  the  CON  and 
HRC  tasks.  The  date  and  time  the  tasks  were  task-built  are  also 
displayed. 

Format 

CON>IDENT 


Example 

CON>IDENT 

CON  --  CONFIGURE  Version  4.00 
Task  built:  l-DEC-81  12:52:43.5 

HRC  —  HRC  Version  004.000 

Task  built:  15-DEC-81  23:59:10.9 
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LIN 


LINK 

The  LINK  command  logically  connects  a  port  of  a  switched  bus  run  to  a 
processor  and  thus  permits  access  to  the  devices  on  the  switched 
segment  of  the  bus  run. 

To  logically  connect  a  switched  bus  run  to  the  processor's  UNIBUS,  the 
devices  on  the  switched  segment  must  all  be  off  line  or  marked  for  on 
line.   You  cannot  dynamically  link  switched  bus  runs. 

Format 

CON>LINK  UBx  TO  CPx 


UBx 


The  target-switched  bus  run.  Switched  bus  runs  are  named  using 
the  designation  UB  followed  by  a  letter  from  the  DIGITAL  hardware 
alphabet  as  follows:  UBE,  UBF,  UBH,  UBJ,  UBK,  UBL,  UBM,  UBN, 
UBP,  UBR,  UBS,  and  UBT. 


CPx 


The  target  processor. 

Example 

CON>LINK  UBE  TO  CPA 

This  command  logically  connects  the  first  switched  bus  run   (UBE) 
to  processor  A  (CPA) . 
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LIST 


LIST 

The  LIST  command  displays  the  current  command  sequence  or  writes  the 
sequence  to  a  file.  You  can  use  this  command  to  keep  a  list  of  the 
commands  that  will  duplicate  the  current  configuration.  If  the  buffer 
in  which  the  current  command  sequence  is  stored  (see  the  description 
of  the  BUILD  command)  is  empty,  CON  returns  the  following  message: 

CON  —  Command  list  is  empty.  Nothing  to  print 

If  you  specify  a  .CMD  file  type,  you  can  execute  the  commands  from  the 
indirect  command  file  (that  is,  BUILD,  LIST  filename.CMD,  ^filename) 
and  then  return  to  CON. 

Format 

CON>LIST  [filespec] 

f ilespec 

Any   legal   RSX-llM-PLUS    file    specification    in    the    form 
ddnn; [ggg,mmm] filename. type; version. 

Example 


CON>BUILD 

CON>LIST 

ONLINE 

RHA 

ONLINE 

RHB 

ONLINE 

RHC 

OFFLINE 

DMA 

OFFLINE 

YLA 

ONLINE 

YZA 

ONLINE 

DKA 

ONLINE 

DLA 

ONLINE 

LPA 

ONLINE 

DBO: 

ONLINE 

DBl: 

ONLINE 

DRO: 

ONLINE 

DRl: 

ONLINE 

MMO: 

ONLINE 

MMl: 

ONLINE 

COO: 

ONLINE 

TTO: 

ONLINE 

TTl: 

ONLINE 

TT2: 

ONLINE 

TT3: 

ONLINE 

TT4: 

ONLINE 

TT5: 

ONLINE 

TT6: 

ONLINE 

TT7: 

ONLINE 

TTIO 

ONLINE 

DKO: 

ONLINE 

DKl: 

ONLINE 

DLO: 

ONLINE 

LPO: 

ONLINE 

NLO: 

ONLINE 

DM0: 

ONLINE 

DM1: 
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OFFLINE 

The  OFFLINE  command  changes  the  state  of  a  quiet  device  to  off-line, 
thus  removing  the  device  from  the  active  set  of  resources  in  the 
current  system  configuration.  This  prevents  further  device  access. 
To  take  a  device  off  line,  it  must  not  have  context  (see  Section 
15.1.3),  and  HRC  nust  be  able,  in  1000(10)  tries  or  less,  to  catch  the 
device  when  there  is  no  I/O  activity  in  progress. 

The  transition  to  the  off-line  state  for  a  specific  device  controller 
is  completed  only  if  all  associated  devices  are  also  off  line.  If  an 
associated  device  is  not  off  line,  HRC  rejects  the  OFFLINE  command 
because  placing  the  device  off  line  could  interfere  with  active  I/O. 

Issue  the  appropriate  MCR  command(s)  to  remove  device  context.  This 
ensures  that  the  device  does  not  have  context  and  can  be  placed  off 
line. 


If  a  task  has  attached  the  device  unit,  the  task  must  be  detached 
request  to  be  aborted)  before  the  unit  can  be  placed  off  line. 


(or 


For  example,  if  you  issue  an  OFFLINE  command  for  a  line  printer 
controller  (such  as  OFF  LPB) ,  and  a  connected  unit  (such  as  LPl:)  has 
context  (in  this  case,  LPl:  is  a  spooled  device  and  attached  by  the 
Queue  Manager) ,  CON  rejects  the  command  and  issues  the  following  error 
message: 

**Unable  to  take  unit  with  context  offline 

If  the  device  is  marked  for  on  line  (for  example,  a  device  unit  with 
its  controller  off  line),  the  command  changes  the  device  state  to 
off-line.  Subsequently,  when  the  controller  is  brought  on  line,  the 
system  does  not  activate  the  device. 

If  the  device  is  marked  for  off  line,  the  command  changes  the  device 
state  to  off-line  and  thus  enables  a  future  on-line  attempt. 


Individual  ports  of  dual-port  devices  can  be  taken  off  line 
separately.  You  may  want  to  do  this  if  the  port  does  not  work 
correctly  (for  example,  you  cannot  access  the  device  through  the  port) 
or  if  you  want  to  increase  system  throughput.  Figure  15-1  is  an 
example  of  the  way  throughput  could  be  increased: 


RHB 


OBOB 


DBO 


6 


RHA 


DBOA 


DB1A 


DB1 


o 


Figure    15-1      Sample   Configuration   for    Increasing   System  Throughput 
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With  this  configuration,  it  is  probable  that  the  system  will  use  the 
DBOA  port.  Because  activity  on  DBl:  must  use  the  DBIA  port,  it  has 
to  wait  until  DBOA  is  free.  If  you  put  only  ports  DBOE  and  DBIA  on 
line,  each  DB  disk  has  its  own  controller  and  does  not  have  to  wait 
for  another  po-   ^o  be  free. 

The  OFFLINE  command  also  accepts  an  optional  keyword,  ALL,  which 
places  off  line  all  devices  except  the  system  disk  and  the  terminal 
that  issued  tne  command.  (The  OFFLINE  ALL  command  is  useful  prior  to 
a  system  save.)  Before  issuing  the  OFFLINE  ALL  command,  you  .nust  first 
dismount  all  volumes  (tapes  and  disks)  except  the  system  disk  and  log 
out  all  terminals  except  the  issuing  terminal. 

Formats 

CON>OFF[LINE]  device-specl [ ,device-spec2. . . ,device-specn] 

CON>OFFtLINE]  ALL 
Note  that  device-spec  also  includes  processors  (CPx) . 
Requirements 

1.  Only  a  privileged  user  can  modify  the  system  configuration. 

2.  No  tasks  are  attached  to  the  device. 

3.  No  volumes  are  mounted  on  the  device. 

4.  If  the  device  is  a  terminal,  no  users  are  logged  in  on  it. 

Example 

CON>OFFLINE  LPA,LPO: 

CON>OFF  yZrt,YZB,Y2C,YZD       !  Terminals  assumed  not  logged  in 

The  command  sequence  logically  places  the  devices  off  line,  which 
allows  the  bus  run  UBE  to  be  placed  off  line. 
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OFFLINE  MEMORY 

(MliI tiprocessor  systems  only.)  The  OFFLINE  MEMORY  command  removes  a 
memory  box  from  the  system  configuration.  Because  memory  must  be 
contiguous,  the  target  box  must  be  the  memory  box  in  the  system 
configuration  with  the  highest  addresses  (the  last  memory  box  added  to 
the  system).  If  the  target  box  is  not  the  last  box  in  the  memory 
configuration,  CON  rejects  the  command  and  issues  the  message: 

**HRC...  Can't  take  box  offline.  Not  last  box  in  memory 

If  a  partition  maps  to  a  memory  box  targeted  for  off-line  status,  CON 
rejects  the  command  and  issues  the  following  message: 

**HRC...  Can't  take  box  offline.  Partition  overmaps  box 

Therefore,  you  must  contract  the  partition  ^Lructure  before  removing 
the  memory  box.  The  MCR  SET  /TOP  command  can  adjust  the  partition 
structure  up  or  down  (see  the  RSX-llM/M-PLUS  MCR  Operations  Manual  for 
details),  but  it  is  your  responsibility  to  ensure  that  nothing  is 
using  the  memory  in  the  memory  box.  The  system  is  protected  so  that 
you  cannot  brJnq  the  memory  box  off  line  if  anything  is  using  it. 

Format 

CON>OFF[LINE]    MEM[ORY]    memory-box 

Exanple 

CON>OFF  MEM  MK2: 

This   command   removes   memory   box    MK2:     from    the    system 
conf  igurat  ion. 


# 
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ONLINE 

The  ONLINE  command  changes  the  state  of  a  device  to  on  line  and 
enables  device  access. 

The  transition  to  the  on-line  state  is  completed  only  if  an  access 
path  exists  between  the  device  and  the  processor,  and  if  the  device 
driver  can  successfully  initialize  the  device. 

If  the  device  lacks  an  access  path,  the  ONLINE  command  changes  device 
state  to  marked  for  on-line;  the  device  is  activated  when  an  on-line 
access  path  becomes  available  (when  the  controller  is  brought  on 
line)  . 

The  ONLINE  command  also  accepts  an  optional  keyword,  ALL,  which  places 
logically  on  line  every  device  controller  and  device  unit  known  to  the 
system. 

Note  that  the  data  base  values  for  interrupt  vector  and  CSR 
assignments  have  no  effect  on  the  system  until  the  device  is  brought 
on  line. 

Formats 

CON>ONL[ INE)  device-specl [ ,device-spec2. . . ,device-specn] 

CON>ONL(INE]  ALL 
Requi  rements 

1.  Only  a  privileged  user  can  modify  the  system  configuration. 

2.  The  specified  device  must  be  physically  present  in  the  target 
syst  n  and  included  in  the  system  at  system  generation. 

3.  If  the  specified  device  is  serviced  by  a  loadable  driver,  the 
driver  and  device  data  base  must  be  loaded. 

The  ONLINE  command  activates  a  device  unit  only  if  the  associated 
controller  is  on  line.  The  command  first  tests  the  unit  to  determine 
whether  it  actually  exists  on  the  controller  and  then  performs  drive 
sizing  to  determine  device  unit  type.  If  the  unit  exists,  it  is  now 
ready  for  user  access.  If  the  associated  controller  is  off  line,  the 
command  marks  the  unit  for  on-line  status;  it  is  presence-tested  and 
sized  when  the  access  path  is  completed  and,  if  present,  activated. 

To  activate  a  device  controller,  the  ONLINE  command  tests  the 
controller's  status  register  (CSR)  to  determine  whether  it  is 
physically  present.  If  the  controller  is  present,  then  all  of  the 
associated  units  that  are  marked  for  on-line  status  are 
presence-tested,  sized,  and  brought  on  line.  Off-line  units  remain  in 
the  relative  off-line  state  regardless  of  any  ONLINE  command  performed 
on  the  associated  controller. 

Tu  .ict-ivate  a  pru.^esrior  on  multiprocessor  systems,  the  ONLINE  command 
issues  a  boot  request  to  the  target  processor.  If  the  target 
processor  ignores  the  boot  request  or  cannot  boot  successfully,  "ON 
issues  the  following  message  (ofter  i  timeont  of  5  seconds): 


**Comrr.and  execution  error.  Device  offline 
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You  can  also  bring  on  line  individually  the  ports  of  a  dual-port 
device,  thus  increasing  system  throughput  because  you  do  not  have  to 
wait  for  both  ports  if  one  does  not  work. 

For  dual-port  terminals,  you  need  a  Status  Control  Block  (SCB)  for 
each  terminal  to  bring  the  ports  of  dual-port  terminals  on  line 
individually  and  to  switch  them  individually.  To  switch  the  ports, 
the  software  will  bring  the  controller  on  line,  but  the  terminals  must 
be  switched  manually  using  the  CSll  switch  on  each  terminal.  If  you 
have  only  one  SCB  for  each  controller,  all  of  the  terminals  on  a 
controller  have  to  be  switched  over  to  the  same  controller. 

Exiimples 

Tne  rol lowing  command  sequence  (used  on  a  multiprocessor  system) 
assumes  that  the  USE  bus  run  has  been  switched  from  CPA  to  CPB. 
The   commands    place    the    software    bus    devices   on    line    for    access: 

CON->ONLINE    LPA.LPO:  I  On    line    line   printer    and    controller 

CON>ONL   yZA, YZB,YZC,YZD  !  On    line    terminal    interfaces 

CON -ONL   TT2: ,TT3: ,TT4: ,TTb:  !  On    line    terminals 
CON > ONL   TT6: ,TT7: ,TT10: ,TT11: 

The  following  command  places  all  devices  on  the  system  logically 
on   line: 

CON>ONL    ALL 

This  command  places  on  line  every  device  controller  and  device 
unit  (except  CPUs)  known  to  the  system  (that  is,  all  controllers 
and  devices  included  at  system  generation).  If  a  device  unit  or 
device  controller  lacks  an  access  path,  the  command  marks  these 
for  on-line  status. 

Note  that  placing  all  devices  on  line  takes  several  seconds  on  a 
large  system  and  that  the  command  does  not  generate  any  error 
messages  saying  that  a  device  may  not  be  on  line. 
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ONLINE  MEMORY 

(Multiprocessor  systems  only.)  The  ONLIME  MEMORY  command  adds  a  memory 
box  to  the  system  configuration.  To  pl^ce  the  additional  memory  on 
line,  you  must  first  place  the  appropriate  memory  box  port  controllers 
and  the  memory  box  itself  logically  on  line.  The  box  you  specify  will 
have  the  highest  memory  addresses. 


To  use  the 
with   the 
Manual )  . 


additional  memory,  ycu  must  expand  the  partition   -tructure 
MCR  SET  /TOP  command  (see  the  RSX-llM/M-PLUS  MCR  Operations 


Format 


CON>ONLrNE   MEMORY    memory-box 


Example 


CON>0NLINE  MEMORY  MK2: 


This   command   adds   the   memory   box 
conf  igurat  ion . 


MK2: 


to    the    system 
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The  SET  command  changes  the  value  of  the  CSR  or  the  interrupt  vector 
address  for  an  off-line  device.  The  values  are  stored  in  the  device 
driver's  data  base. 

SET  cannot  verify  the   CSR  or   interrupt   vector   address   that  you 

specify.   If  you  specify  an  incorrect  CSR  address,  the  system  will  not 

be  able  to  access  the  device  when  you  issue  the  ONLINE  command  for  the 

device.    If   you   specify   an  incorrect  interrupt  vector  address,  the 

system  will  send  interrupts  to  nonexistent  interrupt  vectors  when  you 
place   the   device   logically  on  line;   the  device  cannot  be  accessed. 

Also,  if  you  specify  an  interrupt  vector  that  is  in  use,  you  v.'ill  get 

an  error  when  you  attempt  to  place  the  controller  on  line.   (See  the 

RSX-llM-PLUS  Guide  to  Writing  an  I/O  Driver  for  descriptions  of  the 
tSR  and  vector  assignment  errors. IT 

On  multiproc  s3or  systems,  the  SET  command  also  activates  the  sanity 
timer  and  enables  an  alarm  if  the  timer  expires. 

Format 

CON>SET  controller  option«value 
controller 

The  device  controller  (for  example,  RHA  or  DMA). 
option 

One  of  the  following: 

CSR      Alters  the  value   of   the   controller's   CSR   address 
stored  in  the  driver  data  base. 

VEC      Alters  the  value  of  the  controller's  interrupt  vector 
address  stored  in  the  driver  data  base. 


TIMER 


(Multiprocessor  systems  only.)  Activates  or 
the  sanity  timer  (controller  is  RHx). 


inhibits 


ALARM 


(Multiprocessor 
an  alarm  upon 
RHx)  . 


systems  only.)  Activates  or   inhibits 
sanity   timer  timeout  (controller  is 


value 


If  the  SET  option  is  CSR,  the  value  mus 
177777(6).    Note   that  if  you  specify 
less,  the  device  is  "unknown"  and  canno 
allows   you   to   use   the  CON  ONLINE  AL 
every  device  on  line  when   the   curren 
differs   from   the  generated  system, 
system  has  a   DMCll   with   a   CSR   addr 
generated  system  has  a  DZll  at  that  add 
to  bring  the  DMCll  on  line  as  a  DZll. 
crash  the  system. 


t 

be 

betwe 

a 

CSR  addr 

t 

be 

place 

L 

command 

t 

hardwar 

For 

sxampl 

ess 

of   1 

ress 

,  CON 

Note 

that 

en  160000(8)  and 
ess  of  160000  or 
d  on  line.  This 
without  bringing 
e  configuration 
e,  if  the  target 
60100,  but  the 
ONL  ALL  attempts 
the  attempt   may 
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If  the  SET  option  is  VFC,  the  value  must  be  less  than  774(8). 

On  nul tiprocessor  systems,  it  the  SET  option  is  TIMER   or   ALARM, 
the  value  is  either  ON  (to  activate)  or  OFF  (to  inhibit). 

Requirements 

The  device  must  be  off  line  and  the  diiver  must  be  loaded. 

Examples 

CON>SET  LPA  VEC=160 

This  command  changes  the  interrupt  vector  address  for   the   first 
line  printer  controller  to  160(8). 

CON>SET  LPA  CSR=177600 

This  command  changes  the  CSR  address  for  the  first   line   printer 
controller  to  177600(8). 
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(Multiprocessor  systems  only.)  The  SWITCH  commanii  logically  inverts 
the  processor  association  of  a  switched  bus  run;  that  is,  it  performs 
an  unlink  operation  followed  by  n  link  operation.  The  command  uses  a 
special  hardware  feature  of  the  DT07  to  quarantee  that  the  switched 
bus  is  linked  to  the  tarqet  processor  after  the  unlink  operation. 
Thus,  the  SWITCH  command  ensures  that  the  switched  bus  will  be 
logically  connected  to  the  desired  processor. 

For  example,  in  a  3-processor  system,  a  properly  configured  switched 
bus  can  be  connected  to  any  one  of  three  processors.  An  UNLINK 
command  permits  any  processor  to  then  link  the  switched  bus.  However, 
the  SWITCH  command  specifies  that  only  a  specific  processor  can  link 
the  switched  bus  run  following  the  unlink  operation.  If  CPA  and  CPB 
are  running  as  a  dual-processor  system  and  CPC  is  a  single-processor 
system,  a  switch  from  CPA  to  CPB  occurs  even  if  CPC  is  trying  to  gain 
control  of  the  bus. 

CON  rejects  the  command  if  a  device  attached  to  the  switched  bus  has 
context  (that  is,  the  device  is  processing  or  allowing  processing  of 
I/O)  . 

Format 

CON>SWITCH  UBx  TO  Cx 

UBx 

The  target-switched  bus  run.  Switched  bus  runs  are  named  using 
the  designation  UB  followed  by  a  let-^er  from  the  DIGITAL  hardware 
alphabet  as  follows:  UBE,  UBF,  UBH,  UBJ,  UBK,  IJBL,  "JBM,  UBN, 
UBP,  UBR,  UBS,  and  UBT. 


CPx 


The  target  processor. 


Example 


CON>OFF  LPA.LPO: 
CON>OFF  YZA,yZB, YZC, YZD 
CON>OFF  TT?: ,TT3: ,TT4: ,TT5: 
CON>OFF  TT<S:  ,TT7:  ,TT10:  ,TTn: 
CON>SWITCH  UBE  TO  CPB 
CON>ONL  LPA,LPO: 
CON>ONL  Y  ■ ,YZB,YZC,YZD 
CON>ONL  T1  : ,TT3: ,TT4: ,TT5: , 
CON>ONL  Tn  : ,TT7: ,TT10: ,TT1 1: 


!  Off  line  printer  and  controller 
!  Off  line  terminal  interfaces 
!  Off  lino  all  terminals 

Terminals  assumed  not  logged  in 

On  line  line  printer  and  controller 

On  line  terminal  interfaces 

On  line  terminals 

(Devices  now  connected  to  CPB) 


This  command  sequence  logically  disconnects  the  first  switched 
bus  run  (UBE)  from  its  respect ive' processor  and  then  logically 
connects  UBE  to  processor  B. 
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UNLINK 

The  UNLINK  command  disconnects  a  port  of  a  switched  bus  run  from  its 
respective  processor.  This  command  reverses  the  effect  of  the  LINK 
command. 

CON  rejects  the  command  if  any  device  attached  to  the  switched  bus  has 
context  (that  is,  the  device  is  processing  or  allowing  processing  of 
I/O)  . 

Format 

CON>UNLINK  UBx 
UBx 

The  switched  bus. 

Example 

CONXJNL  UBE      !  Terminals  assumed  not  logged  in 

This  command  disconnects  the  switched  bus  port  of   UBE   from   its 
respective  processor. 
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15.5.1  Hardware  Faults 

Hardware  faults  can  be  placed  in  the  following  categories: 

Media  failures 

Transient  failures 

Intermittent  failures 

Soft  errors 

Hard  errors 
The  following  sections  describe  each  of  these  types  of  faults. 


15.5.1.1  Media  Failures  -  Media  failures  occur  when  i/O  operations 
fail  because  portions  of  the  medium  (a  disk  or  tape)  are  bad.  For 
both  disks  and  tapes,  when  a  media  failure  is  detected,  read 
operations  are  retried. 

Before  disks  are  initialized,  you  should  check  them  for  faulty  sectors 
with  the  BAD  utility.  BAD  marks  the  bad  sectors,  which  prevents  the 
file  system  from  using  them.  (See  the  RSX-llM/M-PLUS  Utilities  Manual 
for  more  information.) 

Occasionally,  sectors  on  the  media  become  bad,  causing  I/O  operations 
to  those  sectors  to  fail.  The  error  logging  system  can  be  used  to 
detect  these  failures.  (See  the  RSX-llM/M-PLUS  Error  Logging  Manual 
for  more  information.)  You  should  probably  replace  faulty  meTI'a  ?  *^ 
they  have  critical  data  recorded  on  them  or  if  a  large  number  ot 
errors  occur  on  them. 

On  devices  supported  by  DUDRV,  bad  blocks  may  be  replaced  by  the  Bad 
Block  Replacement  Control  Task  (RCT) .  See  Chapter  5  for  more 
information  on  this  process. 


15.5.1.2  Transient  Failures  -  Transient  failures  cannot  be  repeated 
and  are  caused  by  electrical  factors  such  as  static  from  clothing  or 
carpeting.  If  che  failure  occurs  on  an  I/O  device,  the  I/O  operation 
is  retrl«?d  automatically  and  the  application  software  never  sees  the 
failui-e.  (The  Error  Logger  records  the  failure,  howevei.)  If  the 
failure  occurs  in  memory  or  in  a  central  processor,  the  system  may 
crash  and  have  to  be  re'^?oted. 
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15.5.1.3  Intermittent  Failures  -  Intermittent  failures  are  caused  by 
irregular  conditions  within  the  system  and  usually  happen  during 
periods  of  high  system  or  device  activity.  The  failures  usually  occur 
where  recorded  data  is  corrupted  enough  so  that  it  cannot  be  read. 
The  data  becomes  corrupted  when  the  device  on  which  it  is  recorded  is 
not  working  properly,  usually  because  of  a  temporary  power  s^iortage. 


intermittent  raiiure  ib  a   uisn   ueviue   detecting   a 
power   failure,   which  causes  the  disk's  volume  valid  bit 


An  example  of  an  intermittent  failure  is  a 
e,   which  causes  the  dii 

clears 


Di  s..iount  ing  and  remounting  the  disk 
allow  I/O  operations  to  proceed. 


d  isk 
ime  ' 
this 


device 

to  be  reset 
condition   and   may 


If  the  sources  of  intermittent  failures  are  not  obvious  or  directly 
reproducible,  try  to  recreate  the  conditions  that  caused  the  failure 
by  using  the  I/O  Exerciser  (lOX).  lOX  simulates  high  system  activity, 
which  could  cause  the  failure  to  recur.  (See  Chapter  4  for 
information  on  lOX) . 


Intermittent 
log. 


failures  that  result  in  device  errors  appear  in  the  error 


15.5.1.4  Soft  Errors  -  Soft  errors  nre  device  errors  that  do  not 
prevent  an  I/O  operation  from  completing  successfully.  The  device 
driver  retries  the  operation  and,  depending  on  the  capabilities  of  the 
device,  performs  ECC  correction  or  disk-head  offset  poL  cioning. 

Soft  errors  usually  indicate  poor  media  or  a  misaligned  device.  For 
example,  disk  heads  that  are  not  aligned  properly  cause  disk  errors. 
These  errors  can  be  corrected  by  haac  offset  positioning. 


If  several  soft  errors  occur  on  a  device,  you  should  find   the 
of  the  errors  and  correct  it  through   ield  service  maintenance. 

Soft  errors  are  recorded  by  the  ''ror  Logger. 


source 


15.5.1.5  Hard  Errors  -  Hard  errors  are  solid  device  failures  that 
prevent  a  device  from  working  properly.  The  errors  make  the  device 
unusable,  but  they  are  also  the  easiest  to  diagnose  and  correct. 

the  disks  and  tapes,  but 
nee   the   failures  are 


Thfc  Error  Logger  records  failed  operations  on  t 
that  information  is  usually  unnecessary  si 
obvious. 


You  can  also  use  lOX  to   test   the   capabilities 
devices  to  determine  if  they  are  failing. 


of  many  peripheral 


15.5.2  Recoverable  and  Nonrecoverable  Errors 

Soft  errors  and  many  media  errors  are  recoverable   errors.    They 
recorded  by  the  Error  Logger  but  do  not  impact  system  operation. 


are 


Hard  errors  and  some  media  errors  are  nonrecoverable  errors.  They 
usually  result  in  recurring  device  errors  and  failure  of  the 
application  software.  (The  application  can  survive  one  failure  on 
each  device  type  before  it  will  stop  processing  completely.)  However, 
the  operating  system  itself  often  survives  the  failure  because  all  it 
requires  to  continue  running  is  the  system  disk,  the  central 
processor (s) ,  and  memory. 
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15.6   FAULT  ISOLATION 

Once  the  software  is  stable,  the  availability  of  a  system  depends  on 
the  reliability  of  individual  devices  and  the  time  required  to  restore 
processing.  RSX-llM-PLUS  systems  can,  in  some  cases,  work  around 
equipment  failures  in  individual  devices,  but  yoi'  must  eventually 
isolate  a  faulty  device,  correct  the  reason  for  the  failure,  and 
restore  it  to  the  system.  Depending  on  the  severity  and  location  of 
the  error,  you  may  have  to  restart  the  application  and/or  the  system. 


Failures  often  exhibit 
device  before  it  can 
should  regularly  monit 
ar.d  their  ability  to  r 
examining  the  error  1 
running  lOX  on  infr 
information  concerning 
comprehensive  error 
devices.  The  tests  ex 
activity. 


symptoms  that  al 
disrupt  system  o 
or  the  condition 
espond  correctly 
og   reports   on 
equently  used  dev 
all  types  of  err 
reports.   lOX  tes 
ercise  combinatio 


low  you  to  detect  a  failing 
peration.  Because  of  this,  you 
of  all  RSX-llM-PLUS  peripherals 
to  I/O  requests  by  periodically 
all  devices  and  occasionally 
ices.  The  Error  Logger  gathers 
ors  as  they  occur  and  generates 
ts  the  validity  of  mass  storage 
ns  of  devices  under   high   I/O 


Both  the  Error  Logger  and  lOX  provide  error  reports  that  contain  a 
description  of  device  fault  conditions.  Use  the  reports  to  determine 
whether  the  device  should  remain  in  operation.  If  the  fault 
conditions  are  transient  (see  Section  15.5.1.2)  and  the  device  is 
capable  of  correctly  performing  its  I/O  functions,  the  device  can 
remain  in  operation.  However,  you  should  closely  monitor  the  device 
and  schedule  it  for  future  maintenance  as  required. 


15.7   SYSTEM  RECOVERY 

The  procedure  you  use  to  diagnose  and  recover  from  a  system  fault 
depends  on  the  primary  use  of  your  system.  If  it  is  mainly  used  for 
application  development,  then  you  would  want  to  use  the  Error  Logger 
or  lOX  to  determine  the  cause  of  a  failure  to  prevent  future  failures. 
If  your  system  is  used  for  process  control  and  is  running  an 
application  that  requires  enhanced  availability,  utilities  such  as  the 
Executive  Debugging  Tool  (XDT)  are  necessary  only  as  much  as  they  can 
be  used  to  isolate  and  correct  failed  components.  Your  main  objective 
is  to  bring  the  system  back  up  and  restart  the  application,  with  only 
limited  diagnostics  for  future  references. 

To  restart  the  system  and  the  application,  first  bring  up  the  minimum 
system  required  for  running  RSX-llM-PLUS.  Then  gradually  bring 
devices  on  line  until  you  have  the  minimum  system  required  for  running 
the  application.  If  any  of  the  devices  are  faulty,  you  can  take  them 
back  out  of  the  system  and  bring  others  on  line  until  you  have  the 
required  configuration. 


The  method  for  recovering 
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would  require  rebooting, 
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The  following  sections  describe  how  to  recover  from  different  kinds  of 
hardware  failures. 


• 
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15.7.1   Device  Unit  and  Controller  Failures 

Most  failures  in  an  operating  system  result  from  disk,  tape,  or  other 
such  device  failures.  Either  the  units  themselves  fail  or  the 
respective  controller  fails. 

The  time  needed  to  reconfigure  around  these  failures  depends  entirely 
on  the  application.  If  the  application  can  notify  an  operator  of  the 
failure,  thus  allowing  the  operator  to  remove  and  inspect  thf  media, 
mount  it  on  another  drive,  and  reintegrate  it  into  the  system,  then 
the  time  to  reconfigure  is  short.  If,  on  the  other  hand,  the  operator 
must  find  a  way  to  halt  the  application,  move  the  media,  and  restart, 
then  the  time  to  reconfigure  increases. 

On  RSX-llM-PLUS  systems,  TKTN  prints  a  message  at  the  console  terminal 
whenever  an  unrecoverable  hardware  error  occurs.   For  example: 

***   DBl:  —  Unrecoverable  hardware  device  error 

These  messages  can  alert  an  operator  to  an  impending  failure  and  allow 
time  to  issue  the  commands  to  remove  the  failing  unit  from  the  system. 


15.  '. 2   Processor  Failures 

Although  it  occurs  rarely  in  comparison  with  device  unit  and 
controller  failures,  a  processor  failure  also  halts  system  operation. 

Not-C  t^.at,  on  it.jI  t  i  processor  sysLems  .  a  crash  or  trap  or  other  failure 
may  orrnr  ->r.    ^    pr~cpr'.sc;r  nthpr  than  ''hr  faulty  nne. 

If  a  processor  fails,  the  system  usually  exhibits  one  of  the  following 
symptoms : 

•  The  system  traps  to  XDT  or  crashess 

•  The   sanity   timer   expires   for   one    or    m'^re    processors 
(multiprocessor  systems  only). 

•  The  console  lights  on  nonremote  diagnostic  consoles  show   that 
the  system  is  halted  in  the  Executive. 

•  The  system  halts  with  no  printouts  or  visual  indicators. 

On  multiprocessor  systems,  regardless  of  the  cause  of  a  processor 
failure,  the  recovery  technique  is  straightforward  and  direct:  you 
must  isolate  and  exclude  the  disabled  processor  and  reboot  the  system. 
The  memory  configuration  need  not  change  unless  you  wish  to  perform 
stand-alone  diagnostics  (see  Section  15.8)  on  the  failed  processor. 


15.7.3  MKll  Memory  Box  Failures 

Th?  two  most  common  causes  of  memory  failures  are  uncorrectable 
double-bit  errors  (parity  errors)  and  loss  of  memory  power. 

If  a  user-state  task  encounters  an  uncorrectable  memory  parity  error, 
the  system  aborts  the  task  and  locks  that  portion  of  memory.  The 
Fixer  task  (FXR)  detects  the  parity  errors  and  creates  a  distinct 
segment  in  the  task's  region  using  the  memory  in  which  the  errors  were 
detected.  This  segment  is  separate  from  the  rest  of  the  region  and  is 
not  used  by  other  tasks.  FXR  is  completely  transparent  to  both  users 
and  tasks. 
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If  the  Executive  or  a  system-state  task  encounters  an  uncorrectable 
parity  error,  the  system  prints  the  following  message  and  then  halts: 

***EXEC  PARITY  ERROR  STOP 

Also,  the  sanity  timers  on  multiprocessing  systems  may  expire. 

Regardless  of  system  state  (user  or  kernel) ,  a  double-bit  error  causes 
the  memory  box  hardware  to  light  the  UNCOR  ERROR  light (s)  on  the 
respective  memory  box  port  controllers. 

When  an  uncorrectable  error  halts  the  system,  you  must  manually 
exclude  that  memory  box  and  reboot.  First,  switch  all  ports  of  the 
faulty  box  off  line.  If  necessary,  use  the  thumbwheel  switches  to 
properly  address  the  remaining  memo  ox{es).  (The  thumbwheel 
switches  are  used  when  the  failed  box  ir  0,  which  is  the  boot  box, 
or  when  you  want  to  disable  a  memory  »  >x  by  changing  the  starting 
addresses  of  the  remaining  boxes.)  Then,  halt  the  processor, 
initialize  it,  and  reboot  the  system. 

When  loss  of  power  causes  the  memory  failure,  the  system  halts.  The 
system  exhibits  one  or  more  of  the  following  symptoms: 

1.  No  lights  or  indicators  are  lit  -  usually  indicates  that  the 
outside  power  supply  has  failed. 

2.  No  MEM  POWER  READY  lights  are  lit  on  memory  box  -  indicates 
that  the  memory  box's  power  supply  has  failed  or  has  been 
powered  down  (check  the  power  switch  on  the  Port  A  controller 
to  the  box)  . 

3.  No  MEM  POWER  READY  lights  are  lit  on  one  port  of  all  memory 
boxes  -  indicates  that  the  CPU's  power  supply  has  failed  or 
the  CPU  has  been  powered  down.  Note  that  the  power  supply 
failure  could  have  come  through  an  expander  box  or  through 
the  far  side  of  a  switched  bus  currently  switched  to  the  CPU. 

In  all  of  the  above  cases,  if  a  CPU  or  a  memory  box  has  been  switched 
off  but  then  switched  back  on  before  the  memory  batteries  discharge, 
the  system  usually  recovers  without  rebooting. 

Otherwise,  to  recover  from  a  memory  box  power  failure,  first  manually 
switch  all  ports  of  the  failed  box  off  line.  If  necessary,  use  the 
thumbwheel  switches  to  properly  address  the  remaining  memory  box(es). 
Then,  halt  and  initialize  the  pirocessor  (s)  and  reboot  the  system. 


15.8   STAND-ALONE  MAINTENANCE  FOR  MULTIPROCESSOR  SYSTEMS 

On  mul t iproressin-j  systems,  when  a  device  fails,  it  is  often  necessary 
to  run  diagnostic  tasks  before  servicing  the  device.  However,  the 
diagnostic  tasks  require  a  processor  for  execution.  Thus,  to  service 
most  devices,  you  must  remove  a  processor  fron\  the  system. 

The  following  list  gives  the  requirements  for  testing  and  servicing 
peripheral  devices: 

1.  A  processor  must  be  available  to  execute  the  diagnostics   for 
the  peripheral . 

2.  Memory  must  be  available  for  the  diagnostics. 

3.  A  mechanism  to  load  the  diagnostic  task  into  memory   must   be 
avai lable. 
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The  processor  that  executes  the  diaqnostlcs  must  be  connected  to  the 
UNIBUn  on  which  the  device  to  be  tester)  resides.  This  implies  that 
othet  peripheialE  on  that  bus  run  will  not  be  available  to  the 
remainder  of  the  system.  Therefore,  when  determining  the  initial 
system  configuration,  you  must  ensure  that  duplicate  devices  are 
located  on  distinct  bus  runs.  If  the  device  to  be  tested  is  on  a 
switched  bus  run,  the  switched  bu£  can  be  connected  to  any  processor 
to  which  it  has  access. 

To  make  memory  available  for  diagnostic  tasks,  the  usual  procedure  is 
to  logically  remove  a  memory  box  from  the  tunning  system  and  use  the 
box  for  diagnostics  only.  This  memory  box  is  then  switched  manually 
so  that  the  processor  to  be  used  for  diagnostics  views  the  box  with  a 
starting  address  of  0. 

For  loading  a  diagnostic  into  memory,  the  RSX-llM-PLUS  multiprocessor 
system  provides  the  Diagnostic  Loader  task  (DLD).  DLD  loads  a 
diagnostic  program  into  a  partition  in  the  memory  box  of  the 
diagnostic  pro  essor  (the  processor  to  which  the  failed  device  Is 
attached).  Diagnostic  programs  ire  system  image  files  that  you  use  to 
test  the  failed  devices.  The  partition  is  created  and  specified  by 
you  and  is  mapped  by  program  logical  ^iddress  space  (PLAS)  directives. 
By  default,  DLD  clears  the  partition  to  the  end  after  loading  the 
program.   The  diagnostic  is  then  run  stand-alone. 


The  steps  for  using  DLD  are  as  followsi 


1.   Use   FLX   to   transfer   the 
diagnostic   tape  or  disk  to 


diagnostic   program    from    the 

a  Files-11  device  attached  to  the 

diagnostic   processor.    (See   the 

for 

•11 


Manual 
Tn  DOS- 


.wv,^^^.,..    v^=^   v..^   RSX-llW/M-PLUS   Utilities 
information  on  FLX.)  Because  the  tape  or  disk  is 

... -.  format,  use  the  FLX   Image   Mode   switch   (/IM)   to 

convert  the  file  (the  diagnostic  program)  to  Files-ll  format. 
The  file  is  in  formatted  binary  format  and  has  a  file  type  of 
.BIC  or  .BIN.  (Note  that  binary  formatted  files  are  not 
patchable. ) 


Reconfigure  your  system  so  that  you  have  a  system  with  two 
CPUs  and  two  memory  boxes,  and  each  box  has  256K  words  of 
memory.   The  configuration  would  be  as  follows: 

BOX  0    PORT  A   ONLINE,  START=000 
PORT  B   OFFLINE 

BOX  1    PORT  A   OFFLINE 

PORT  B   ONLINE,  START=000 


IIST 


Off  1 ine  both  sides. 


3.   Boot  RSX-llM-PLUS  on  CPA. 

-l.   Set  BOX  0  PORT  A  to  ONLINE,  START=010 

5.  Bring  Box  1  on   line.    This   memory   box   will   contain   the 
diagnostic  partition.   For  example: 

CON>ONL  MKE,MK2: 

6.  Use  the  CON  DISPLAY  command  to  find  out  the  base  address   and 
size  of  the  memory  box.   For  example: 

CON>DISP  FULL  ATT  FOR  MK2: 

The  base  address  of  the  partition  will  be  the  base  address  of 
the  diagnostic  program. 
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7.  Create  the  diagnostic  partition  in  the  memory  box  by  using 
the  command  SET  /PAR  and  specifying  type  DIAG.  This 
partition  will  be  devoted  to  diagnostic  functions  and  should 
begin  at  the  location  in  memory  that  the  diagnostic  processor 
will  see  as    location  0  or  the  bottom  of  memory.   For  example: 

>SET  /PAR=JIMK-^0000: 1777:DIAG 

This  command  creates  a  partition  named  JIMK  with  a  base 
address  of  2000000  and  consisting  of  1777(10)  32-word  blocks. 
The  other  processors  see  the  memory  box  used  for  diagnostics 
as  starting  at  location  2000000,  but  the  processor  running 
the  diagnostic  will  see  the  box  as  starting  at  location  0. 

Other  partition  types  used  with  the  SET  /PAR  command  ensure 
that  the  requested  memory  is  within  the  syst«='m  !;:>age  area 
(less  than  SSYSIZ),  but  DIAG  ensures  only  that  the  memory 
physically  exists.  For  the  other  processor  to  run 
concurrently  with  the  diagnostic  processor,  the  partition 
must  be  larger  than  $FYSIZ. 

8.  Use  DLD  to  convert  the  binary  formatted  file  into  a  bootable 
system  image  file  (patchable  with  ZAP;  see  the 
RSX-llM/W-PLUS  Utilites  Manual )  and  then  to  load  it  into  the 
partition.   The  DLD  commancf  line  has  the  following  format: 

DLD> [partition] (/HEl =f i lename f . typ) [/qualifierl 

partition 

The  partition  created  in  the  diagnostic  processor's 
memory  box  into  which  the  diagnostic  program  will  be 
loaded.  You  must  specify  a  partition  name  it  you  do  not 
use  the  /NL  switch  (see  below).  DLD  produces  a 
"partition  not  found"  error  message  otherwise.  If  you 
specify  both  a  partition  name  and  the  /NL  switch,  the 
switch  overrides  the  name. 


/HE 


typ 


Provides  a  briel  description  of  DLD's  use  an^  format 


The  file  type  for  the  diagnostic  program.  File  type  can 
be  .BIC,  .BIN,  or  .SYG., 

If  the  file  type  is  .BIC  or  .BIN,  DLD  converts  the  file 
into  a  system  image  file.  If  you  specify  either  file 
type,  but  DLD  cannot  find  the  file,  it  searches  for  the 
other  file  type  before  giving  up.  If  you  do  not  specify 
any  file  type,  DLD  first  looks  for  a  file  with  the  .BIC 
file  type  and  then  for  one  with  the  .BIN  file  type. 

If  the  file  type  is  .SYS,  DLD  does  not  have  to  convert 
the  file;   it  is  ready  to  be  loaded  into  the  memory  box. 

/qual i  f ier 

One    of    the    following: 

/NL  lahii>its    loiiding    of    the      d  i  ■•irji..;:;t !.;      pr;:^rar!; 

(DLD  only  creates   the   system    image    file). 
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/NC  Inhibits  clearing  (zeroing)  of  any  r«>mdining 
memory  in  the  par*  •  .»fter  the  diagnostic 
program  has  b<?en  ;  .  The  default  is  to 
clear  the  remaining  memory. 

/OFF:n  offsets  the  starting  location  of  the  load  by 
n  times  32(10)  words.  The  area  between  the 
beginning  of  the  partition  and  the  beginning 
of  the  diagnostic  is  untouched. 

/LI  List?  information  about  the  partition  and 
the  file:  the  partition  name  (if  yoti  have 
specified  one),  the  base  and  size  of  the 
partition*  and  the  new  name  of  the  system 
image  file  (if  converted). 

Specifying  this  switch  gives  you  the 
transfer  address  (usually  200  or  lOOOi  of 
the  diagnostic  proqrar.  The  transfer 
address  Is  needed  to  initiate  the 
diagnost I " . 

/LW  Accounts  tor  the  Dt:>-il  MnK  wor  l  that  may 
exist  in  bytes  0  and  1  of  every  input  block. 


Example 


nLn>JIMK«TEST.BIN/l.I 

PARTITION  SAMF:    IIMK 

PARTITION  BASE:   20000     SIZEl   1777  (32.  WORD  BLOCKS) 

FILE  NAME:   TEST. SYS; 1 

TRANSFER  ADDRESS:   200 

This  command  sequence  converts  the  binary  formatted 
diagnostic  file  TEST. BIN  into  the  system  image  file  TEST. SYS. 
DLD  also  lists  the  transfer  tddress  of  the  file  and  other 
Information  about  the  file  and  the  partition. 

9.  DLD  loads  the  program  Into  a  region  that  it  creates  in  the 
diagnostic  partition.  The  region  is  called  DIAG  and  is  the  same 
size  as  the  partition.  After  the  program  is  loaded,  DLD  clears 
any  remaining  memory  from  the  partition  (unless  otherwise 
spec' f  ieJ)  . 

10.   To  run  the  diagnostic  program,  halt  the  processor  (in  this   casio, 

CPB)  ,   toggle   in   the  transfer  address  of  the  progr.im  (from  uslrg 

the  /I  r  switch),  and  then  push   the   START  button   to  begin  t'\e 
diagpo  tics. 

1,1,   Use  the  MCR  command  line 

REMOVE  DIAG/REG 

•■Q  remove  the  diagnostic  partition  from  the  memory  box. 


15.9   ERROR  MESSAGES 

The  CON  and  HRC  error   messages   consist   of   one   or   more   lines   of 
Informati  n  in  the  following  format: 


•CON  -~  error  message 
(detail  of  error  Reasage) 
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The  first  line  is  the  general   error   message.    The   second   and   any 
succeeding  lines  define  the  error  message. 

In  addition   to   the  description,   the  error  messages  may   include 

Directive    Status   Word   error   codes  and   I/O  error   codes.    For 

explanations  of  these  codes,   refer   to  the   lAS/RSX   I/O  Operations 
Reference  Manual . 

A  list  of  the  CON  and  HRC  error  messages  and  a   brief   explanation   of 
each  follows. 


15.9.1  CON  Error  Messages 

CON  —  Bad  indirect  command  file  specification 

Explanation:  The  name  of  an  indirect  command  file  (fifilename,  is 
syntactically  incorrect. 

CON  —  Command  execution  error 

Explanation:  CON  cannot  process  the  specified  command 
line.   (More  specific  information  is  also  given.) 

CON  —  Command  intent  inconsistent  with  device  state 

Explanation:  An  attempt  was  made  to  place  on  line  a  device  that 
13  in  the  marked  for  off-line  state. 

CON  —  Command  list  is  empty.  Nothing  to  print 

Explanation:  The  CON  LIST  command  was  issued  when  CON's  internal 
buffer  was  empty. 

CON  —  Command  syntax  error 

Explanation:  The  command  line  do*'-  not  conform  to  command  syntax 
rules. 

The  command  is  displayed  with  a  question  mark  (?)   following   the 

last   recognized   keyword   or  parameter  typed  by  the  user.   Check 

the  command  description  for  correct  format  and  reenter  the 
command  line. 

CON  —  CONFIGURE  Version  nnn 

Explanation:   This  message  is  returned  by  the  CON  IDENT  command. 

CON  —  CON  is  unable  to  do  an  extend  task  operation  to  obtain  pool  for 
a  read  of  the  system  configuration.  Please  ensure  that  a 
checkpoint  file  has  been  allocated  and  reissue  the  CON  command 

Explanation:   Self-explanatory. 

CON  —  File  open  er ror/FILE=f 1 lename/No  such  file 

Explanation:  An  invalid  file  specification  was  used  with  the 
LIST  command.  Check  the  device  name  and  UFD  and  reenter  the 
command  line. 

CON  —  HRC  has  timed  out  during  initialization 

Explanation:  This  message  could  indicate  an  error  in  the  I/O 
data  structure.  Please  verify  that  your  device  data  structures 
are  correct. 
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CON  —  HRC  version  nnn 

Explanation;   This  message  Is  returned  by  the  CON  IDENT  command. 

CON  —  Illegal  command 

Explanation:  The  command  is  not  a  valid  CON  command  or  a  valid 
command  was  used  illegally. 

CON  —  Illegal  keyword 

Explanation:  The  keyword  is  not  valid  for  the  specified  CON 
command  or  a  valid  keyword  was  used  illegally. 

CON  —  Initialization  error 

Explanation:  CON  was  unable  to  properly  initialize  itself  or  its 
links  with  the  RD:  driver  and  the  HRC...  task.  Verify  that  the 
driver  is  loaded  and  that  HRC...   is  installed. 

CON  —  Initialization  request  of  HRC...  has  failed.  Please  ensure  that 
HRC. . .  is  installed. 

Explanation:   CON  is  unable  to  start  HRC  running. 

CON  —  Input  error  on  input  command  fi^e 
FILE«f ilename 

Explanation:  The  file  you  have  specified  exists,  but  CON  could 
not  read  it. 

CON  —  Internal  consistency  error 

Explanation:  An  error  internal  to  either  CON  or  HRC  has 
occurred.  This  is  most  often  an  internal  addressing  trap  or  a 
malfunctioning  driver.  Submit  a  Software  Performance  Report 
(SPR)  if  the  problem  seems  to  be  with  DIGITAL-standard  software. 

CON  —  Internal  core  pool  exhausted 

Explanation:  CON  has  run  out  of  internal  pool  space  or  was 
invoked  without  checkpoint  space  first  being  allocated.  If  out 
of  pool  space,  check  the  /MAXEXT  setting.  (See  the  description 
of  the  SET  command  in  the  RSX-llM/M-PLUS  MCR  Operations  Manual.) 

CON  —  Maximum  indirect  command  file  depth  exceeded 

Explanation:  You  have  specified  that  CON  use  an  indirect  command 
file  that  exceeds  CON ' s  maximum  nesting  depth  of  three. 

CON  —  No  device  name  matches  select  string 

Explanation:  You  have  specified  with  the  DISPLAY  command  a 
logical  device  name  that  does  not  exist  in  the  system. 

CON  —  No  HRC  version  information  available 

Explanation:  This  message  is  returned  by  the  CON  IDENT  command 
if  HRC  is  not  installed. 

CON  —  No  reconfiguration  driver  is  available 
Output  to  HRC  is  suppressed 

Explanation:  The  reconfiguration  driver  (RD:)  is  not  loaded  in 
the  system. 
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CON  —  Open  error  on  input  command  file 
PILE-f i lename 

Explanation:   The  input  file  you  have  specified  does  not  exist. 

CON  —  Unable  to  assign  command  LUN 

Explanation:  CON  was  unable  to  assign  its  command  input  LUN  to 
TI:  . 

CON  —  Unknown  command  error 

Explanation:  For  undetermined  reasons,  CON  cannot  read  the 
command. 

CON  —  Unknown  device  or  invalid  device  specification 

Explanation:  The  device  specified  for  a  command  other  than  the 
DISPLAY  command  is  not  known  to  the  system.  Consult  the  system 
conf i lurat ion  for  the  proper  name  of  the  target  device. 

CON  —  You  must  be  privileged  to  modify  the  system  configuration 

Explanation:  The  command  specified  in  the  command  line  must  be 
issued  from  a  privileged  terminal. 


15.9.2   HRC  Error  Messages 

The  following  messages  are  related  to  HRC  but  also  come  from  CON. 

Attempt  to  quiet  unit  for  controller  failed 

Explanation:  When  a  controller  with  units  on  line  is  taken  off 
line,  the  on-line  units  are  quieted  and  set  to  the  marked  for 
on-line  state.  HRC  attempts  to  access  the  unit  when  it  does  not 
have  context  and  can  be  taken  off  line.  HRC  makes  1000(10) 
attempts  to  quiet  the  device.  If  the  device  has  not  been 
successfully  accessed  after  the  1000  attempts,  CON  displays  this 
message. 

Attribute  format  error 

Explanation:  HRC  received  a  read  or  write  attributes  QIO  in 
which  the  desired  attributes  were  either  incorrectly  specified  or 
inappropriate  for  the  specified  device. 

CSR  for  controller  not  present  in  I/O  page 

Explanation:  An  attempt  was  made  to  bring  on  line  a  controller 
that  does  not  exist  in  the  current  hardware  configuration. 

Device  already  linked 

Fxplanation:  A  LINK  command  was  issued  for  a  bus  run  that  is 
already  linked  to  a  CPU. 

Device  not  linked 

Explanation:  An  UNLINK  command  was  issued  for  a  bus  run  that  is 
not  currently  linked  to  a  CPU. 
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Device  is  unknown  in  this  configuration 

Explanation;  HRC  has  received  a  request  to  bring  on  line  a 
device  that  is  unknown  because  it  had  been  previously  assigned  a 
CSR  address  of  160000  or  less. 

Executive  or  driver  status  change  error 

Fxplanation:  During  a  controller  on-line  or  off-line  operation, 
either  the  executive  controller  status  change  routines 
($ONKRB/$OFKRB)  or  the  driver's  controller  status  change  routine 
(xxKRB)  were  unable  to  change  the  state  of  the  controller. 

HRC...  can't  take  box  ofrline.  Not  last  box  in  memory 

Explanation:  An  attempt  was  made  to  take  off  line  a  memory  box 
that  is  not  at  the  end  of  the  current  physical  memory 
conf igurat  ion. 

HRC...  can't  take  box  offline.  Partition  overmaps  box 

Explanation:  An  attempt  was  made  to  take  a  memory  box  off  line, 
but  the  memory  is  currently  in  use  for  a  partition.  The 
partition  must  either  be  removed  with  SET  /NOPAR  or  reduced  in 
size  with  SET  /TOP  fsee  the  RSX-llM/M-PLUS  MCR  Operations 
Manual '  . 

HRC...  detected  I/O  data  base  consistency  error 

Explanation:  During  the  course  of  taking  a  device  off  line,  HRC 
detected  an  error  in  the  structure  of  the  system  device  data 
base. 

HRC...  internal  addressing  error 

Explanation:  An  odd  address  trap  (or  other  software  trap)  has 
occurred  within  HRC.  This  may  be  due  to  a  bug  in  HRC  or  an 
inconsistency  in  the  system's  I/O  data  base. 

HRC...  internal  tables  insufficient  for  this  system 

Explanation:  HRC  creates  a  list  of  units  on  the  stack  when 
taking  a  controller  off  line.  This  message  is  produced  if  HRC 
encounters  a  controller  with  too  many  units  to  create  a  list. 
The  maximum  number  of  units  for  each  controller  is  defined  by  the 
symbol  .MXCTL  in  HRPRE  and  is  currently  set  to  256(10). 

HRC...  invalid  device  specification 

Explanation:  HRC  received  a  request  to  bring  memory  on  line,  but 
the  specified  device  was  not  a  memory  box. 

HRC...  request  format  error 

Explanation:  HRC  received  a  QIO  in  which  the  format  of  the 
parameters  was  incorrect.  If  the  issuing  task  for  the  request 
was  CON,  this  error  implies  a  software  fault. 

HRC...  unable  to  access  device  to  size  drive 

Explanation:  When  certain  types  of  device  units  are  brought  on 
line,  HRC  must  "size"  the  drive  (for  example,  to  determine  if  a 
DB:-type  device  is  an  RP05  or  an  RP06) .  This  message  is  issued 
if  the  sizing  process  fails  for  any  reason  (for  example,  the 
drive  is  not  powered  up  when  the  CON  ONL  command  is  issued) . 
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HRC...  unknown  error  from  online/offline  call 

Explanation:  HRC  received  from  the  driver  on-line/off-line  call 
an  unsuccessful  status  that  is  not  one  of  the  normally  expected 
return  codes. 

Invalid  device  descriptor 

Explanation:  HRC  received  a  request  to  take  a  port  off  line,  but 
the  port  description  was  invalid. 

Memory  box  parameter  error 

Explanation:  An  attempt  has  been  made  to  brinq  on  line  a  set  of 
memory  boxes  whose  current  physical  configuration  does  not  allow 
the  specified  command  to  be  executed. 

Offline  controller  failure 

Explanation:  HRC  attempted  to  take  a  controller  off  line,  but 
the  controller  did  not  properly  change  state.  However,  no 
explicit  error  was  recognized. 

Offline  unit  failure 

Explanation:  HRC  attempted  to  take  a  unit  off  line,  but  the  unit 
did  not  properly  change  state.  However,  no  explicit  error  was 
recogni  zed. 

Parameter  error 

Explanation:  HRC  received  a  request  to  link  a  bus  run,  but  the 
device  specified  was  not  a  bus  switch.  If  the  requesting  task 
was  CON,  this  probably  implies  a  software  fault. 

Syntax  error 

Explanation:  HRC  received  a  command  to  link  a  bus  run  to  a 
device  that  is  not  a  CPU. 

Timeout  on  unit  quieting  operation 

Explanation:  HRC  was  unsuccessful  in  attempting  to  "catch"  a 
unit  in  its  quiet  state  to  take  it  off  line  after  1000(10) 
attempts. 

Unable  to  access  bus  run 

Explanation:   HRC  was  unable  to  create  or  remove  the  vectors  for 

a  device  because  the  device's  bus  run  was  inaccessible.   Because 

HRC  checks  bus  run  status  and  uses  the  marked  for  on-line   state 

for  devices  on  off-line  bus  runs,  this  message  probably  implies  a 
software  fault. 

Unable  to  switch  unit  from  the  current  controller 

Explanation:   This  error  is  displayed  for  two  reasons: 

1.  HRC  attempted  to  take  off  line  the  controller  for   a   port 
to  which  the  bus  switch  is  currently  switched. 

2.  HRC  attempted  to  take  off  line  a  controlltir   (with   units) 
whose  access  path  cannot  be  changed. 
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Unable  to  take  unit  with  context  offline 

Explanation:   An  attempt  was  made  to  take  one   of   the   following 
units  off  line: 

•  A  mounted  Files-11  device 

•  An  attached  device 

•  A  logged-in  terminal 

•  A  bus  switch  whose  bus  run  is  currently  linked 

•  A  memory  box  unit  whos"  memory  is  currently  on  line 


» 
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CHAPTER  16 
RSX-llM-PLUS  I/O  QUEUE  OPTIMIZATION 


I/O  Queue  Optimization  is  used  to  improve  the  throughput  of  the  disk 
subsystem  used  in  your  RSX-llM-PLUS  system.  Disk  throughput  is 
improved  by  making  the  most  effective  use  of  the  list  of  I/O  requests 
in  the  queue  for  a  particular  disk  device.  The  I/O  queue  for  the 
device  is  scanned  by  I/O  Queue  Optimization  and  after  each  request  is 
examined,  tho  best  request  is  dequeued  and  passed  to  the  I/O  driver 
for  processing.  How  Queue  Optimization  determines  which  I/O  request 
is  best,  depends  on  which  method  of  I/O  Queue  Optimization  is  used. 
There  are  three  methods  of  I/O  Queue  Optimization  available  (you  can 
also  choose  not  to  have  I/O  Queue  Optimization): 

Nearest  Cylinder 
Elevator 
Cylinder  Scan 

The  method  that  serves  you  best  depends  on  your  processing 
environment.  All  three  methods  attempt  to  minimize  head-seek  time, 
which  decreases  the  seek-time  component  of  the  file  service  time. 

Since  I/O  Queue  Optimization  works  by  optimizing  requests  in  the 
queue,  optimization  happens  only  when  I/O  requests  are  present  in  the 
queue.  If  the  system  loading  is  such  that  there  are  few,  if  any, 
requests  in  the  queue,  little  optimization  is  achieved. 

Without  I/O  Queue  Optimization,  the  operating  system  groups  the  I/O 
requests  in  the  queue,  by  priority,  on  a  first-in  first-out  basis. 
The  highest  priority  requests  appear  first  in  the  queue  and  are 
processed  in  sequence.  With  I/O  Queue  Optimization,  the  I/O  requests 
within  priority  groups  are  examined  and  the  request  having  the 
appropriate  disk  address  is  chosen  as  the  next  I/O  operation.  The 
highest  priority  requests  are  still  serviced  first.  However, 
throughput  is  increased  by  advantageous  reordering  of  requests  within 
priority. 

In  some  cases,  I/O  Queue  Optimization  may  provide  smoother  disk 
operation  by  reducing  erratic  head  movement. 


16.1   INITIATING  OPTIMIZATION 

Tlie  MCR  SET  /OPT  command  is  used  to  initiate  I/O  Queue  Optimization. 
The  parameters  in  this  command  are  used  to  specify  the  disk  device, 
the  method  of  optimization,  and  a  fairness  count  limit  for  passed  over 
I/O  requests.  These  parameters  are  explained  in  detail  in  following 
paragraphs. 

The  SET  command  is  only  for  privileged  users.  Nonpr ivileged  users  can 
use  this  command  only  to  display  the  optimization  status  of  devices  in 
the  system. 
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Format: 

SET  /(NO]OPT[-ddn:opttype:fairnesscount.] 
Parameters 
ddn 

The  disk  device  requiring  optimization: 

DBn  RP04,RP05,RP06  Pack  Disks 

DRn  RM02,RM03,RM05,RM80,RP07  Pack  Disks 

DMn  RK06  and  WK07  Cartridge  Disks 

DLn  RLOl  and  RL02  Cartridge  Disks 

opttype 

The  type  of  optimization  needed: 

NEAR[EST)  Initiates  Nearest  Cylinder  method;  next  request 
picked  is  the  closest  to  current  request. 

ELEV[ATnR]  Initiates  Elevator  method;  requests  are  processed 
first  in  one  direction  along  the  disk  and  then  in 
the  reverse  direction. 

CSCAN  Initiates  Cylinder  Scan  method;  requests  are 
processed  in  ortiy  one  direction  along  the  disk 
(lowest  to  highest). 

The  default  is  NEAREST. 

f airnesscount 

A  limit  on  the   number   of   times   the  most   unsatisfactory   I/O 
request  is  passed  over  (see  Section  16.2.1). 

The  default  is  10. 


• 


16.1.1   Displaying  Optimization  Status 

You  can  display  the  optimization  status  for  all  devices  in  the   system 
that  are  currently  using  I/O  Queue  Optimization  by  entering: 

>SET  /OPT 
This  displays  status  in  the  form: 

OPT«ddn:opttype:f airnesscount 

For  example: 

0PT=DB0:NEAR:10. 

0PT-DB1:ELEV:5. 

OPT»DB2:CSCAN:8. 

You  can   also  display  which  devices   are   not   using    I/O   Queue 
Optimization  by  entering: 

>SET  /NOOPT 

This  displays  status  in  the  form: 

NOOPT-ddn: 
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For  example: 

NOOPT-DRl: 
Nonpr ivlleged  as  well  as  privileged  users  can  display  status. 

16.2   SELECTING  THE  TYPE  OF  OPTIMIZATION 

Selecting  the  correct  optimization  method  is  dependent  upon  the  I/O 
processing  environment  in  which  your  application  is  running,  the 
physical  location  of  data  on  the  disk  drive,  and  how  often  tasks 
access  certain  data  areas. 

A  general  guideline  is  to  try  the  default  first.  (This  initiates  the 
Nearest  Cylinder  method  with  a  fairness  count  limit  of  10.)  Then 
compare  the  difference  in  throughput  by  timing  the  application  runtime 
against  a  suitable  clock.  For  a  closer  look  at  disk  activity  and 
throughput,  use  Resource  Accounting  (see  Chapter  17).  Resource 
Accounting  provides  this  data  under  the  heading  DEVICE  STATISTICS  in 
the  output  from  the  Resource  Accounting  transaction  file. 

The  default  (.NEAREST  and  a  fairness  count  of  10)  is  an  average  setting 
and,  in  most  cases,  should  improve  I/O  throughput.  After  a  closer 
observation  and  as  you  become  more  familiar  with  the  I/O  load  and  data 
organization  on  the  disk  in  your  application,  you  can  make 
adjustments.  You  can  change  the  fairness  count  limit  or  use  on<  of 
the  other  methods  cf  I/O  Queue  Optimization. 


16.2.1  Adjusting  the  Fairness  Count  Limit 

When  using  I/O  Queue  Optimization,  you  should  watch  for  increased 
waiting  time.  I/O  requests  to  some  data  areas  may  have  slower  than 
normal  access  times,  because  Optimization  categorizes  them  as 
unsatisfactory.  When  this  happens.  Optimization  passes  over  these 
requests  for  a  better  choice,  keeping  the  unsatisfactory  requests  in 
the  queue  longer.  This  may  cause  a  decrease  in  performance  for  some 
tasks  even  though  overall  system  performance  has  improved. 

To  counteract  increased  waiting  time  and  acquire  a  better  balance,  you 
can  adjust  the  fairness  count  limit.  This  puts  a  limit  on  how  many 
times  an  I/O  request  can  be  passed  over.  Optimization  increments  the 
fairness  count  for  the  first  I/O  request  in  the  queue  whenever  that 
request  in  the  queue  is  passed  over.  When  the  fairness  count  for  an 
I/O  request  reaches  the  limit  indicated  with  the  SET  command,  the 
request  is  dequeued  and  the  fairness  count  is  cleared. 

Decreasing  the  fairness  count  limit  reduces  waiting  time  but  decreases 
the  overall  throughput  initially  gained  with  the  higher  count.  If  you 
find  you  must  decrease  the  fairness  count  limit,  try  another 
optimization  method.   It  may  be  more  applicable  to  your  situation. 


16.2.2  Nearest  Cylinder 

The  Nearest  Cylinder  method  processes  the  I/O  request  that  is  closest 
to  the  current  cylinder.  In  general,  this  method  is  effective  for 
both  long  and  short  I/O  queues.  There  may  be  an  increase  in  waiting 
time,  however,  and  this  may  be  unacceptable  in  an  interactive 
environment.  To  remedy  this,  reduce  the  fairness  count  limit,  which 
reduces  the  throughput,  or  try  one  of  the  other  optimization  methods. 
(Elevator  may  be  the  next  best  choice.) 
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16.2.3   Elevator 

The  Elevator  method  processes   I/O  requests   like  an   elevator.    It 

processes   requests  as  it  moves  in  one  direction  along  the  disk  until 

it  reaches  the  last  request  in  that  direction.   Elevator  then  cnanges 

direction  and   processes   requests  in  that  direction.   This  method  is 


effective  if  there  are  many  I/O  requests  outstanding.  Also,  waiting 
time  tends  to  be  less  with  the  Elevator  method  than  with  the  Nearest 
Cylinder  method. 

The  Elevator  method  favors  the  center  of  the  disk.  Requests  are  done 
as  they  are  passed,  and  the  center  of  the  disk  tends  to  be  passed  over 
twice  as  often  as  the  periphery.  So  a  task  that  has  a  number  of 
requests  located  in  the  center  of  the  disk  tends  to  have  faster  I/O 
than  a  task  with  requests  at  the  periphery. 


16.2.4   Cylinder  Scan 

The  Cylinder  Scan  optimization  method  operates  like  the  Elevator 
method  except  the  Cylinder  Scan  method  processes  I/O  requests  only 
while  passing  in  one  direction  along  the  disk.  The  direction  is 
lowest  cylinder  number  to  highest  cylinder  number.  This  method  is 
most  effective  if  each  task  tends  to  do  I/O  to  a  localized  area  on  the 
disk.   Tt  results  in  a  more  even  distribution  of  I/O  among  tasks. 


16.3   ERROR  MESSAGES 

SET  —  Privileged  command 

Nonpr ivileged  users  can  only  display  status. 

SET  --  Feature  not  supported 

User  tried  to  initiate  Optimization  for  a  disk  device   that   does 
not  support  Optimization. 

SET  --  Device  not  In  system 

User  tried  to  Initiate  Optimization  for  a  disk  device  that  Is  not 
mounted  In  the  system. 

SET  —  Illegal  keyword  value 

User  specified  a  fairness  count  higher  than  128(10). 
SET  —  Invalid  keyword 

User  tried  to  use  an  Invalid  keyword. 
SET  —  Device  offline  or  privileged  diagnostic 

User  tried  to  initiate  Optimization  for  an  off-line  device. 
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CHAPTER  17 
RSX-llM-PLUS  RESOURCE  ACCOUNTING 

17.1   INTRODUCTION 

RSX-llM-PLUS  Resource  Accounting  is  a  system  generation  option  that 
provides  a  transaction  file  of  system  usage  information.  Accounting 
gathers  data  tor  both  the  user  and  the  system.  The  data  allows  the 
billing  of  individual  users  for  the  resources  used,  as  well  as  the 
measuring  of  overall  system  usage. 

Some  of  the  system  usage  information  gathered  by  Resource  Accounting 
and  saved  in  the  transaction  file  is: 

User  Data 

•  Session  identification,  terminal,  and  account  number 

•  Billing  stop  date  and  time 

•  CPU  usage  time 

•  Tasks  active  at  time  of  logoff  or  crash 

•  Number  of  tasks  run 

•  Number  of  directives  and  QIOs  issued 

•  Status  at  logoff  or  crash 
Task  Data 

•  Session  identification,  terminal,  and  account  number 

•  Disk  overlay  loads 

•  Number  of  times  checkpointed 

•  Number  of  times  context  has  been  loaded 

•  Highest  running  priority 

•  Task  begin  time  and  end  time 

•  CPU  usage  time 

•  Number  of  directives  and  QIOs  issued 

•  Status  at  logoff  or  crash 
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System  Data 

•  Accounting  start  date  and  time 

•  Accounting  stop  date  and  time  (0  if  system  crashes) 

•  Shutdown  code 

•  Transaction  file  ID,  sequence  number,  and  device 

e  Last  scan  date,  time,  and  scan  rate  in  seconds 

e  Total  CPU  time  and  total  CPU  zero  intervals 

e  Total  number  of  tasks  executed 

e  Total  number  of  logons 

e  Number  of  current  users 

•  Number  of  checkpoints 

e  Number  of  Shuffler  runs 

e  Number  of  directives  Issued 

•  Number  of  QIOs  issued 
Logon  Data  or  Invalid  Logon  Data 

•  User  name,  ID,  terminal,  and  account  number 
e  Logon  UIC,  date,  and  time 

e  Illegal  password 

Device  Allocation,  Deallocation  Data,  or  Dismount  Data 

•  Session  ID,  terminal,  and  account  number 

e  Allocation  or  deallocation  date,  time,  and  device 

Device  Mount 

e  Session  ID,  terminal,  and  account  number 

•  Mount  date,  time,  and  device 

e  Volume  label  for  Flles-11  mounted  device 

•  Type  of  mount  (foreign,  shared,  and  so  on) 
e  Owner  UIC 

•  Volume  protection  code 

•  Name  of  ACP  for  device 
Print  Job  Data 

•  Session  ID,  terminal,  and  account  number 

•  Print  job  date  and  time 
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•  Job  name  ar<d  page  count 

•  Number  of  files  printed,  printer  device,  and  forms  number 

•  Job  priority 
Card  Reader  Job  Data 

•  Session  ID,  terminal,  and  account  number 

•  Batch  or  print  job  name 

•  Number  of  cards  read 

•  Reader  device  name  and  number 
System  Time  Change 

•  Old  Time 

•  New  Time 
Device  Usage  Data 

•  I/O  counts 

•  Error  counts 

•  Tuning  information 

There  are  several  ways  to  access  the  system  usage  information 
contained  in  the  transaction  file.   They  are: 

•  The  SHOW  ACCOUNTING  commands  (see  Section  17.3)! 

-  SHOW   ACCOUNTING/INFORMATION   displays    system    usage 
information  about  specific  terminals 

-  SHOW   ACCOUNTING/TRANSACTION  FILE  generates   a    formatted 
version  of  the  transaction  fTle 

•  A  report  program  written  by  DATATRIEVE-11  (see  Section  17.4) 

•  User-written  analysis  programs  (see  Section  17.5) 

Resource  Accounting  gathers  system  usage  information  by  collecting  the 
data  in  account  blocks  in  secondary  pool  and  writing  each  account 
block  as  a  record  in  the  transaction  file.   These  account  blocks  are: 

•  Task  Account  Block  (TAB) 

•  User  Account  Block  (UAB) 

•  System  Account  Block  (SAB) 

•  Transaction  account  blocks 

For  a  description  of  account  blocks,  their  structure,  and  how  Resource 
Accounting  uses  them,  see  Section  17.6. 
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The  following  sections  describe  the  Resource  Accounting  commands. 
Parameters  are  separated  by  spaces,  you  may  abbreviate,  and  you  are 
prompted   for   missing   parameters.     All    commands,    except    SHOW 


ACCOUNTING/INFORMATION,   are   privileged, 
commands  are  optional.) 


(Slashes   in   SET  and  SHOW 


The  Resource  Accounting  commands  are: 
START/ACCOUNTING 

STOP/ACCOUNTING 

SET  ACCOUNTING 

SHOW  ACCOUNTING/INFORMATION 


Starts   up   the 
subsystem 

Shuts    down    the 
subsystem 


Accounting 
Accounting 


Changes  parameters  in  a  started 
Accounting  subsystem 

Displays  Accounting  information 
about  a  specific  terminal 

SHOW  ACCOUNTING/TRANSACTION_FILE   Converts  the   transaction   file 

to  a  readable  format  so  it  can 
be  displayed  on  a  terminal  or 
put  in  a  file 


SHOW  ACCOUNTING/DATATRIEVE 


Converts  a  transaction  file  to 
a  file  that  is  readable  by 
DATATRIEVE-11. 


• 
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START/ACCOUNTING 


17.2   CONTROL  COMMANDS 

17.2.1   START/ACCOUNTING  Command 

The  START/ACCOUNTING  command  starts  up  the  Accounting  subsystem.  The 
SYSLOG  and  ...ACC  tasks  must  be  installed  before  you  issue  the 
START/ACCOUNTING  command.  If  you  do  not  supply  the  optional 
parameters,  they  assume  defauliis. 

Format 

START/ACCOUNTING  [parameterl] [parametern] 

Parameter 

FILE:f ilespec 

This  f ilespec  is  the  name  of  the  transaction  file  that  Accounting 
creates  to  store  the  data.  You  can  name  the  file  with  this 
parameter  or  accept  the  default,  LB: [ 1 ,6] ACNTRN. SYS. 

EXTEND_SIZE:value 

This  value  is  the  size  of  the  initial  allocation  for  the 
transaction  file  and  for  each  extension  when  it  is  needed.  The 
value  can  be  any  reasonable  amount.  If  there  is  low  Accounting 
activity,  a  small  extension  size  is  adequate  because  few 
extensions  are  required  and  overhead  is  low.  If  Accounting 
activity  is  high,  a  larger  extension  size  lowers  the  overhead  if 
disk  space  is  available  for  the  larger  extension. 

The  default  value  is  10(10)  blocks. 

POOL_RESERVE:decimal  value 

This  value  is   the   number   of   blocks   of   secondary  pool   that 

Accounting  must  leave  free  after  each  allocation.   If  Accounting 

cannot  leave  this  amount  free,  the  allocation  will  fail  and 
prevent  the  swamping  of  secondary  pool. 

The  default  is  a  quarter  of  the  total  secondary  pool  size.  Use 
of  the  default  is  recommended. 

SYSTEM_STATISTICS: yes/no 

This  parameter  specifies  to  Accounting  whether  or  not  to 
accumulate  system-wide  statistics.  System-wide  statistics  are 
the  contents  of  the  accumulation  fields  in  the  System  Account 
Block.   These  fields  are: 

B.CPU  Total  CPU  time  used 

B.DIR  Total  directive  count 
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START/ACCOUNTING  (Cont.) 

B.QIO  Total  QIO$  count 
B.TAS  Total  task  count 
The  default  is  yes. 

STATISTICS_SCAN [ : val uel 

This  value  specifies  a  scan  rate  for  the  collection  of  device 
statistics.  These  device  statistics  are  mainly  used  to  measure 
seek-optimizat ion  parameters.  They  also  provide  excellent 
information  on  disk  activity  and  throughput.  The  device 
statistics  are  collected  either  once  or  periodically.  To 
indicate  a  one-time  only  collection,  no  value  is  specified.  To 
collect  statistics  periodically,  the  value  specifies  the  rate  in 
minutes  (nM)  or  seconds  (nS).  The  default  value  is  one  hour  if 
SYSTEM_STATISTICS:YES  is  specified. 

If  STATISTICS  SCAN  is  specified,  SYSTEM_STATISTICS  must  be 
specified.  Tfiis  restriction  does  not  apply  to  a  one-time  only 
request.  If  a  value  of  0  is  specified  or  SYSTEM_STATISTICS:NO  is 
specified,  this  feature  is  turned  off.  The  example  below  shows 
the  type  of  statistics  collected  in  a  transaction  file. 

SCAN_RATE:decimal  value 

This  value  is  the  time  interval  between  the  periods  when 
Accounting  writes  the  SAB  and  active  UABs  to  the  scan  file  called 
LB: [ 1 ,6)SYSSCAN.TMP  for  protection  against  loss  in  event  of  a 
system  crash.  The  value  can  be  supplied  as  "nM"  or  "n"  for  n 
minutes,  or  "nS"  for  seconds.  If  you  specify  0,  no  scanning  is 
done;  therefore,  if  the  system  crashes,  the  active  UABs  and  the 
SAB  are  not  recorded  in  the  transaction  file  and  the  data  is 
lost. 

The  default  value  is  five  minutes. 

If  Accounting  finds  a  scan  file  when  you  start,  it  outputs  a 
crash  transaction  and  copies  the  data  in  the  scan  file  to  the  new 
transaction  file.  A  copy  of  this  crash  transaction  followed  by 
the  transaction  file  is  shown  as  the  output  of  the  SHOW 
ACCOUNTING/TRANSACTION  FILE  command  in  Section  17.3.2. 
Accounting  copies  alT  the  old  data  before  it  writes  the  startup 
transaction  and  before  it  processes  any  new  data. 

When  you  stop  Accounting,  the  scan  file  is  deleted. 

CRASH_REASON: yes/no 

If  you  enter  "yes"  and  Accounting  is  started  after  a  crash  that 
occurred  when  scanning  was  active.  Accounting  prompts  you  to 
enter  a  reason  for  the  crash.  The  reason  can  be  as  many  as  60 
characters   in   length  and   is  stored   in   the   Crash   Recovery 
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START/ACCOUNTING  (Cont.) 


Transaction  Block.  Accounting  prompts  for  "reason  for  crash" 
when  Accounting  is  restarted.  If  the  system  did  not  crash,  no 
prompt  occurs. 

If  you  enter  "no",  a  prompt  never  occurs;   the  default  is  no. 


TASK: yes/ no 


If  you  enter  "yes,"  task  accounting  is  initiated.  Task 
accounting  gathers  data  on  individual  tasks  running  in  the 
system.  You  can  run  task  accounting  when  the  system  is  running 
at  peak  load  times  and  the  task  accounting  data  can  be  analyzed 
on  a  per  task  basis  to  identify  heavy  resource  users. 

If  you  enter  "no,"  task  accounting  is  stopped.  The  default  is 
no. 

Task  accounting  should  only  be  specified  when  you  absolutely  need 
task  accounting  data.  The  reason  is  that  task  accounting 
requires  substantial  disk  space  because  the  transaction  file  can 
become  quite  large. 
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START/ACCOUNTING  (Cont.) 


Exaapl* 


The  type  of  device  statistics  collected  by  Resource  Accounting  is 
shown  in  the  following  output  from  a  transaction  file: 

DEVICE  statistics; 

TIME  OF  DEVICE  STATISTICS  =-  l5-tiEC-81  16!27:23     DEVICE  =  DRl  : 
10  COUNT  -  0.  UORDS  TRANSFERRED  COUNT  «  0. 

SOFT  ERROR  LIMIT  =  8.  SOFT  ERROR  COUNT  -  0. 

HARD  ERROR  LIMIT  =  5.  HARD  ERROR  COUNT  «  C. 

CYLINDER  CROSSED  COUNT  =  0.        CURRENT  FAIRNESS  COUNT  »  0. 
FAIRNESS  COUNT  LIMIT  •  10. 

DEVICE  STATISTICS 

TIMt  OF  DEVICE  STATISTICS  =«  15-DEC-81  16:27:23     DEVICE  «  DR2: 
10  COUNT  »  13832.  WORDS  TRANSFEKRED  COUNT  «  9002804. 

SOFT  ERROR  LIMIT  »  8.  SOFT  tRKUR  COUNT  •  0. 

HARD  ERROR  LIMIT  =  5.  HARD  ERROR  COUNT  =  0. 

CYLINDER  CROSSED  COUNT  =  1053      CURRENT  FAIRNESS  COUNT  =  0. 

FAIRNESS  COUNT  LIMIT  «  10. 

DEVICE  STATISTICS 

TIME  OF  DEVICE  STATISTICS  =  15-DEC-81  16:27:24     DEVICE  -  DR3; 
10  COUNT  >  68490.  UORDS  TRANSFERRED  COUNT  >  80640304. 

SOFT  ERROR  LIMIT  •  8.  SOFT  ERROR  COUNT  =  0. 

HARD  ERROR  LIMIT  =  5.  HARD  ERROR  COUNT  =■  0. 

CYLINDER  CROSSED  COUNT  '  .113.      CURRENT  FAIRNESS  COUNT  =  7. 

FAIRNESS  COUMf  LIMIT  '  10. 

Some  definitions  are: 

ID  COUNT  is  the  number  of  I/O  requests. 

WORDS  TRANSFERRED  COUNT  is  the  number  of  words  transferred. 

SOFT  ERROR  is  a  recovered  error. 

HARD  ERROR  is  a  nonrecovered  error.  (See  the  RSX-llM/M-PLUS 
Error  Logging  Reference  Manual  for  more  information  about 
hard  and  soft  errors.) 

CYLINDER  CROSSED  COUNT  is  how  many  cylinders  were  crossed 
while  accessing  data.  This  data  can  be  analyzed  for  I/O 
Queue  Optimization  purposes. 

FAIRNESS  COUNT  is  a  Queue  Optimization  parameter  that 
indicates  how  many  times  an  I/O  request  was  passed  over  (see 
Chapter  16) . 
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SET/ACCOUNTING 


17.2.2   SET  ACCOUNTING  Command 

This  command  allows  ycu  to  change  the  value  of  parameters  specified 
when  Resource  Accounting  was  started  with  the  START/ACCOUNTING  command 
or  previously  modified  with  a  SET  command.  (A  transaction  is  written 
containing  the  old  value  and  the  new.) 

The  following  options  can  be  changed  while  Resource  Accounting  is 
running . 

•  The  file  transactions  are  written  to 

•  The  size  of  the  extensions 

•  The  scan  rate  for  the  scan  file 

•  The  scan  rate  for  collecting  device  statistics 

•  The  state  of  task  accounting  (on  or  off) 
Format 

SET  ACCOUNTING/lparameterl] [parametern] 

Parameter 

FILE(:f ilespecl 

Changes  the  file  transactions  are  written  to.    Defaults   to   the 
current  filespec,  if  not  specified. 

EXTEND_SIZE:value 

This  value  changes  the  size  of  the  transaction  file  specified   in 
the  START/ACCOUNTING  EXTEND_SIZE  parameter. 

STATISTICS_SCAN : val ue 

This   value   changes   the   scan   rate    for   collecting   device 
statistics.   A  value  of  0  stops  this  option. 

SCANRATErvalue 

This  value  changes  the  scan  rate  for  the  scan  file   specified   In 
the  SCANRATE  parameter.   A  value  of  0  stops  this  option. 
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SET/ACCOUNTING  (Cont.) 

TASK: yes/no 

If  you  enter  "yes,"  task  accounting  is  started. 

When  specified,  task  accounting  creates  task  account  blocks  for 
all  active  tasks  in  the  system.  All  data,  for  each  task,  is 
gathered  starting  at  this  time. 

If  you  enter  "no,"  task  accounting  is  stopped. 

When  specified,  task  accounting  on  a  per  task  basis  is  terminated 
and  the  data  for  all  active  tasks  is  written  to  the  transaction 
file.  The  only  exception  is  tasks  that  have  a  CPU  time  limit 
specified,  since  the  data  is  necessary  for  the  time  limit  to  be 
checked.  The  data  for  these  tasks  is  written  to  the  transaction 
file  when  the  task  exits. 


• 


• 
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STOP/ACCOUNTING 


17.2.3   STOP/ACCOUNTING  Command 

This  command   shuts   down   the   Resource   Accounting  subsystem.  The 

parameter   is   provided   to  indicate  why  the  shutdown  is  occurring  and 

must  be  entered  with  the  command.    Accounting   puts  the   reason  for 
stopping  into  the  System  Account  Block. 

Formats 

STOP/ACCOUNTING  reason 

STOP/ACCOUNTING  CLEAN_UP 

Reason 

MAINTENANCE 

You  can  use  this  reason   when   you   stop   Accounting   for   system 
maintenance. 

REBOOT 

You  can  use  this  reason  if  you  must  reboot  the  system. 

SCHEDULED_SHUTDOWN 

You  can  use  this  reason  when  the  system  Is   being   shut   down   or 
used  for  other  purposes  where  Accounting  is  not  applicable. 


SHUTUP 


The  SHUTUP  program  uses  this  reason  as  a  default  because   it   has 
no  means  of  determining  a  shutdown  reason. 

OTHER 

You  can  use  this  reason  when  any  of  the   above   reasons   are   not 
adequate. 

The  STOP/ACCOUNTING  CLEAN  UP  command  has  a  special  use.  It  must  be 
used  if  the  SYSLOG  task  aForts  or  Accounting  encounters  a  fatal  error. 
This  command  cleans  up  all  the  data  structures  to  allow  Accounting  to 
restart  successfully.  Accounting  accepts  this  command  only  if  it  is 
necessary  (after  an  Accounting  failure  or  abort). 

When  you  use  this  command,  the  system  assumes  all  Accounting  data  in 
memory  to  be  invalid  and  deallocates  the  data  back  to  secondary  pool 
without  writing  it  to  the  transaction  file.  Note  that  if  the 
Accounting  data  structures  are  corrupted,  the  system  may  crash  while 
it  attempts  to  deallocate  secondary  pool. 

You  can  restart  Accounting  normally  after  you  issue  this  command. 
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SHOW  ACCOUNTING/INFORMATION 

17.3   SHOW  COMMANDS 

17.3.1   SHOW  ACCOUNTING/INFORMATION  Comnand 

This  command  displays  on  the  terminal  from  which  the  command  was 
issued  the  Accounting  information  for  the  specified  terminal. 
Nonpr ivileged  users  can  receive  only  their  Accounting  data.  A 
privileged  user  can  obtain  any  Accounting  data. 

Format 

SHOW  ACCOUNTING/INFORMATION (parameter! 

Parameter 

TTn: 

If  you  specify  TTn:,  this  command  displays  the  Accounting  data 
fo..  the  specified  terminal.  A  privileged  user  has  access  to  the 
Accounting  data  of  any  terminal  on  the  system.  A  nonpr ivileged 
user  can  only  get  his  own  data.   The  default  terminal  is  TI:. 

If  you  enter  no  terminal  name,  the  Accounting  data  of  the 
terminal  issuing  the  command  is  displayed. 


CO: 


SYS 


If  you  specify  CO:,  the   Accounting   data   of   the   system   tasks 
running  is  displayed  on  the  terminal. 


If  you  specify  SYS,  the  current  system  totals   are  displayed  on 
the  terminal. 


TASK=taskname 


Shows  Accounting  data  for  the  specified  task   if   the   system   is 
maintaining  task  accounting. 
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SHOW  ACCOUNTING/TRANSACTION_FILE 


17.3.2   SHOW  ACCOUNTING/TRANSACTIONPILE  Command 

The  SHOW  ACCOUNTING/TRANSACTION_FILE  command  converts  the  transaction 
file  into  a  readable  format.  It  either  displays  this  file  on  a 
terminal  or  writes  it  into  another  file.  The  SHOW  ACCOUNTING/- 
TRANSACTION_FILE  command  uses  the  current  transaction  file  as  the 
default  file.  (When  Accounting  is  not  running,  there  is  no  default 
file.) 

Format 

SHOW  ACCOUNTING/TRANSACTION_FILE(:inputf ilespec]  outputf i leapec 

Parameter 

inputf ilespec 

The  input  file  is  the  transaction  file  to  be  read.   If  you  do  not 
specify  an  input  file,  the  current  transaction  file  is  used. 

outputf ilespec 

The  output  file  can  be  either  a  terminal  (specified  as  TTn :   or 
TI:)  or  a  file  of  your  choice. 


Notes 


UIC  [126,10]  on  the  distribution  kit  includes  the  source  code  for 
the  SHOW  ACCOUNTING/TRANSACTION_FILE  command  to  serve  as  an 
example  for  how  to  read  the  file.  Note  that  the  record  size  in 
the  file  is  equal  to  the  transaction  length.  The  only  exception 
to  this  is  the  Accounting  startup  transaction  that  only  occurs 
once  and  is  512(10)  bytes  long.  The  startup  transaction  consists 
of  a  header  only,  but  its  size  is  increased  to  512(10)  bytes  to 
force  a  file  extension.  See  Section  17.6  or  [126,10]  ACNDF.DOC 
on  the  'distribution  kit  for  the  format  of  this  file. 


Example 


The  output  of  the  SHOW  ACCOUNTING/TRANSACTION_FILE  command  is  a 
formatted  display  of  the  transaction  file.  The  default  file  is 
the  transaction  file  named  in  the  START/ACCOUNTING  command.  This 
example  of  output  of  a  SHOW  ACCOUNTING/TRANSACTION_FILE  command 
is  keyed  to  the  following  explanatory  comments: 


ACCOUNTING    DATA     •    CURRENT    ^liE  ll-tiEC-ei     16:56:04 

SYSTEM  CRASH  RECORH 

TIME  OF  LAST  SCAN  =  7-IiEC-ei  10:48:i7      SCAN  RATE  (SEC)  -  300.  Q 
RESTART  TIME  =  7-DEC-81  19:58:15 
REASON  =  O 
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SHOW  ACCOUNTING/TRANSACTION_FILE  (Cont.) 


USER  -  ALPHA     P  O 

SESSION  ID  ■  rU43        Ti:  •  TT40!     ACCOUNT  ■  1. 

LOOON  UIC  ■  C7tlin       LOOOED  ON  •  7-DEC-Bt  08:S8:53 

LOOOED  OFF  •  00-000-00  00:00:00     BILLING  STOPPED  •  7-DEC-ei  10:48:17 

CPU  ■  4461.  TASKS  ACTIVE  ■  1.  TASKS  RUN  >  95. 

0108  ■  621S.  DIRECTIVES  «  10240. 

STATUS      ACT    CRN 


USER  -  SYSTEtl  TASKS 

SESSION  ID  ■  tSYO  Ti;  >  COS       ACCOUNT  ■  0. 

LOGON  UIC  •  COfO]  LOGGED  ON  -  6-DEC-81  1S:48:16 

LOGGED  OFF  ■  00-00-00  00:00:00   BILLING  STOPPED  ■  7-DEC-Bl  10!48il7 

CPU  ■  1038A6.  TASKS  ACTIVE  -  9.        TASKS  RUN  «  601. 

QIOS  -  128967.  DIRECTIVES  •  667250. 

STATUS      ACT    CRH 

TOTAL  SYSTEM  STATISTICS  O 

ACCOUNTING  STARTED  •  6-DEC-81  15:48:16 

ACCOUNTING  STOPPED  •  00-000-00  00:00:00     SHUTDOWN  CODE  •  0 

TRANS  FILE  ID  >  1422        SEQ  NUN  °  1  DEVICE  '    DBi: 

TIME  OF  LAST  SCAN  »  7-DEC-81  10:48:i7      SCAN  RATE  (SEC)  «  300. 

TOTAL  CPU  ■  441264.        ZERO  CPU  INTERVALS  »  374665. 

TOTAL  TASKS  •  3236.  TOTAL  LOGONS  >  60. 

CURRENT  USERS  •  27.        CHECKPOINTS  •  23. 

SHF  RUNS  ■  0.  DIRECTIVES  «=  2373564.       OIOS  -  556015. 

ACCOUNTING  STARTUP 

ACCOUNTING  STARTED  •  7-DEC-ei  19:58:16 

LOGIN  -  BETA  B 

SESSION  ID  •  RXPl         Ti:  «  TT26:     ACCOUNT  ■  0. 
LOGON  UIC  •  C7tl02D       TIME  =■  7-0EC-81  19:58:35 

LOGIN  -  ALPHA  P 

SESSION  ID  »  F112         Ti:  •  TT55:     ACCOUNT  =  1. 
LOGON  UIC  »  C7rlll]       TIME  »  7-DEC-81  20:05:44 

DEVICE  MOUNT 

SESSION  ID  =  F112         Ti:  :•  TT55:     ACCOUNT  =  1. 

TIME  =  7-DEC-81  20:06:37  DEVICE  =  Df*i:      VQl  ID  =  UELCOMEBACK 

OWNER  UIC  ■  to. 03  ACP  NAME  'FllACP       VOL  PROT  MASK  '  0 

USER  -  ALPHA  P 

SESSION  ID  =  F112         Ti:  =  TT55:     ACCOUNT  ^  I. 

LOGON  UIC  »  C7.1in       LOGOED  ON  =  '-DEC-81  20:05;44 

LOGGED  OFf  •  7-DEC-81  20:06:43      PILLING  STOPPED  =  7-DEC-81  20:06;43 

CPU  «  141.  TASKS  ACTIVfc  ■=  0.  TASKS  RUN  =  17. 

DIRECTIVES  =  472.    QIOS  •  16<>. 
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SHOW  ACCOUNTING/TRANSACTION  J^ILE  (Cont.) 


LOGIN  -  OHEOA  V 

SESSION  ID  ■  RXP3 
LOGON  UIC  •  C7t7n 


TI!  ■  TT37:     ACCOUNT  •  4. 
TIME  «  7-DEC-ei  20!08:U 


DEVICE  ALLOCATION 

SESSION  ID  -  RXP4         Ti:  «  TT37: 
TIME  ■  7-DEC-Sl  20!09tl2      DEVICE  ■ 


ACCOUNT  •  4, 
DLO: 


LOGIN  -  THETA  D 

SESSION  III  •  SF-R5 
LOGON  UIC  ■  t7.327] 


TI!  ■=  TT55!     ACCOUNT  ■  0. 
TIME  '    7-DEC-8I  20:0?!14 


DEVICE  MOUNT 

SESSION  ID  -  RXP4         Tl:  -  TT37i     ACCOUNT  «  4. 

TIME  «  7-DEC-81  20:09:i5      DEVICE  •  HLO:      VOL  ID  =■ 

OWNER  UIC  ■=  1 7.  1073       ACF'  NAME  «  TSTACP     VOL  FfOT  MASK  •  0 


DEVICE  DEALLOCATION 

SESSION  It"  =  RXf4  Tl:  =»  T137:      ACCOUNT  «  4, 

TIME  »  7-DEC-81  20:09:i5      DEVICE  «  DLO: 


USER  -  SYSTEM  TAShS 

SESSION  ID  •  »SYO       ri :  =  co:      account  «  o. 

LOGON  UIC  '  CO.OJ  LOGGF.Ii  ON  =  7DEi:-91  19:58:16 

LOGGED  OFF  =  00-000-00  00!00:00  tULINO  STOFFfJi  .  7-DEC-Bl  20:13:21 

CF'U  =  1A03.  TASKS  ACTIVt  =  4.  TASKS  FUN  '  64. 

DIRECTIVES  =■  r9fi6. 


TOTAL  SYSTEM  STATISTICS 

ACCOUNTING  STARTED  " 
ACCOUNTING  STOFFED  ' 
IRANS  FILE  ID  '  :05 
STATISTICAL  SCAN  RATE 
TIME  OF  LAST  SCAN  :     7 
TOTAL  CFU  '    4260. 
lOTAL  TASKS  «  243. 
CURRENT  USERS  '  I. 
SHF  RUNS  =  0. 


7-DEC-81  19:'je:ie 
7-DEC-81  20:13:21 
StO  HUM  =  20 
(SEC. )  -  3600. 

-DEC -81  2o:n:i7 

:ER0  CFU  INTERVALS 
IOTA!  LOGONS.  »  7 
CHECKFOINTS  =  0. 
I'lRECTIVES  »  10241. 


SHUTDOWN  CODE  >  4 
DCVICI  -  DRO: 
FILE  EXT.  &I:E  -  10. 
SCAN  RATE  (SFC)  •  300. 
306.'. 


OIOS 


4946. 


The  crash  reason  appears  here  if  Accounting   prompts   you   for   a 
reason  for  the  crash.   The  prompt  occurs  only  if  you  answered  yes 

parameter  in  the  START/ACCOUNTING  command. 


to  the  CRASH  REASON 


^  To  minimize  loss  of  data.  Accounting  writes  the  SABs  and 
currently  active  UABs  to  a  temporary  file  every  n  seconds  or 
minutes   unless   you   specify   a    zero    scan    rate    in    the 


START/ACCOUNTING   command, 
called  a  scan.    When   you 
existing   temporary   file 
file  now  starting.   If  the 
memory-resident   until  you 


The  process  of  writing  this  file  is 
restart   Accounting,   it   copies   any 

of  Accounting  data  into  the  Accounting 
scan   rate   is   zero,   the   SABs   are 

stop  Accounting  or  the  system  crashes. 
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SHOW  ACCOUNTING/TRANSACTION_FILE  (Cont.) 


Also,  the  currently  active  UABs  are  memory-resident  until  a  user 
logs  off.  Therefore,  if  a  crash  occurs  with  the  scan  rate  At 
zero,  all  the  SAB  and  current  UAB  data  is  lost. 

O  1'he  User  Account  Block  (P.  Alpha)  shows  a  logged  off  date  and 
time  of  zero  because  the  system  crashed.  There  may  or  may  not  be 
a  "status"  line  as  the  last  line  of  the  User  Account  Block.  The 
status  line  indicates  the  bit  setting  of  the  status  mask  byte 
(B.STM)  in  the  UAB.  Three  of  the  bits  have  external  importance 
and  cause  this  line  to  appear  if  they  are  on.   These  bits  are: 

ACT  (BS.ACT)  Indicates  that  the  UAB  was  written  to  the 
file  while  still  active  (all  activity  had  not 
ceased).  This  can  happen  when  UABs  are 
copied  from  the  scan  file,  or  when  all  the 
dat^  structures  are  written  out  because 
Accounting  has  stopped. 

LGO  (BS.LGO)  Indicates  that  the  user  has  logged  off  with 
tasks  remaining  active  or  with  clock  queue 
requests  pending. 

CRH  (BS.CRH)    Indicates  that  this  UAB  came  from   the   scan 

file  and  was  copied  into  the  transaction  file 

when  Accounting  was  started  after   a   system 
crash. 

O  The  TOTAL  SYSTEM  STATISTICS  block  contains  the  shutdown  code  as  a 
digit  in  the  range  0  through  5.  These  digits  have  the  following 
meanings: 

0  Accounting  not  stopped  due  to  crash 

1  Maintenance 

2  Reboot 

3  Scheduled  shutdown 

4  Shutup 

5  Other 

The  ZERO  CPU  INTERVALS  field  shows  the  possible  error  In  the  CPU 
time  measurements.  The  error  occurs  because  the  system  clock  is 
usually  run  at  60  Hz  and  is  slower  than  the  context  switch  time 
of  the  Executive.  Therefore,  a  task  can  sometimes  execute  for 
"zero"  ticks,  because  the  time  needed  for  Its  execution  is  less 
t*  n  the  resolution  of  the  clock.  Resource  Accounting  rounds 
e.  h  zero  tick  to  one-half  tick  of  CPU  time  and  counts  them.  The 
ZERO  CPU  INTERVALS  field  contains  the  count  of  the  number  of  zero 
ticks  that  have  occurred. 
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17.4   WRITING  AN  ACCOUNTING  REPORT  PROGRAM  USING  DATATRIEVE-H 

The  data  collected  In  the  transaction  file  pertains  to  your  computing 
environment.  How  you  Interpret  and  analyze  this  data  depends  on  your 
objectives.  For  Instance,  are  you  Interested  in  billing  or  system 
measurement?  To  obtain  the  Accounting  data  you  are  looking  for,  in 
the  form  you  want,  you  will  most  likely  write  your  own  report  program. 
This  program  accesses  the  transaction  file,  reads  the  required  data 
fields,  and  writes  a  report  containing  the  Resource  Accounting  data 
you  are  Interested  in. 

One  way  to  write  this  specialized  re*"  "■  is  to  use  DATATRIEVE-1 1 .  But 
before  a  DATATRIEVE-1 1  program  cai.  -cess  the  transaction  file,  the 
file  must  be  converted  to  a  DATATRIEVE-1 1  readable  file.  To  convert 
the  file,  use  the  Resource  ^ccounting  SHOW  ACCOUNTING/DATATRIEVE 
command  (see  Section  17.4.1).  The  format  of  the  converted  file  is 
shown  in  LB:  ( 12<),  24)  ACNTRN.CMD  along  with  an  example  of  a  simple 
report  generator  written  in  DATATRIEVE-1 1. 

To  obtain  a  report  using  the  example  report  generator,  you  must: 

1.  Use  the  SHOW  ACCOUNTING  command  (see  Section  17.4.1)  to 
convert  the  appropriate  transaction  file  to  a  file  that  is 
readable  by  DATATRIEVE-1 1.  Name  the  file  ACCOUNT.DAT  (this 
is  the  name  used  in  ACNTRN.CMD,  for  example  purposes  only) . 

2.  Copy  the  following  files  from  the  system  disk  to  your 
di  rectory: 

[i,2]0UERY.DIC 

(126, 241ACNTRN.CMD 


the   following   command 


After  the  above  files  are  made  available,  use 
line  to  generate  a  report: 

>DTR  ^ACNTRN.CMD 

This  command  line  calls  DATATRIEVE-1 1  and  executes  the  DATATRIEVE-11 
commands  in  the  ACNTRN.CMD  file.  A  brief  description  is  then 
displayed  on  your  terminal  screen  with  a  portion  of  the  DATATRIEVE-11 
commands  that  make  up  the  report  generator.  After  this  you  are 
prompted  with: 

Enter  DEVICE  OR  FILE; 

You  then  enter  where  you  want  the  Resource  Accounting  information 
displayed.  The  Information  can  be  displayed  on  a  device  or  directed 
to  a  file.   For  example,  the  device  could  be  your  terminal: 


Enter  DEVICE  OR  FILE; 


TI; 


If  you  wanted  to  put  the  information  in   a   file   ..amed   ACT. REP,   the 
response  would  be: 


Enter  DEVICE  OR  FILE; 


ACT. REP 


While  creating  the  report,  you  are  prompted  to  respond  with  where  the 
report  should  be  displayed.  These  prompts  appear  at  junctures  In  the 
report  generating  process  where  certain  parts  of  the  report  can  be 
either  dlplayed  or  directed  to  a  file.  For  example,  the  first  prompt 
you  receive  Is  at  a  point  where  the  STARTUP  TRANSACTION  part  of  the 
report  can  be  displayed.    The   next  prompt  Is  at  a  point  where  the 


17-17 


R8X-11M-PLUS  RESOURCE  ACCOUNTING 

first  part  of  USER  ACCOUNT  BLOCK  TRANSACTION  can  be  displayed.  At 
•ach  prompt,  you  can  direct  that  part  of  the  report  to  the  same  report 
file,  a  different  report  file,  or  to  a  device. 

To  stop  the  Resource  Accounting  report  process  before  it  is  finished, 
you  must  abort  DTR.  If  this  is  done,  you  must  recopy  (1,21  QUERY. DIC 
back  into  your  area  before  using  the  example  Resource  Accounting 
report  program. 


17.4.1   SHOW  ACCOUNTING/DATATRIEVE  Command 

This  command  allows  you  to  write  your  own  Resource  Accounting  report 
generator  using  DATATRIEVE-1 1.  This  command  is  used  to  convert  an 
existing  transaction  file  to  a  file  that  is  readable  by  DATATRIEVE-1 1. 

Poraat 

SHOW  ACCOUNTING/DATATRIEVE[:trnsf llespec]  outfllespec 

Parameter 

trnsf ilespec 

Specifies  the  name  of  an  existing  Resource  Accounting  transaction 
file. 

outf i lespec 

Specifies  the   name  of   the  output   file  where   the   converted 
transaction  file  is  to  reside. 


17.5   USER  TASK  INTERFACE  FOR  CREATING  TRANSACTIONS 

You  can  define  and  create  your  own  transactions  and  write  them  into 
the  transaction  file  by  using  specific  entry  points  In  the  Executive 
Accounting  module.  The  task  that  you  write  must  be  privileged.  The 
privileged  task  must  enter  the  system  state  (by  means  of  SSWSTK)  and 
call  one  of  the  following  entry  points  in  the  Executive  module  ACSUB; 
SOTRAN,  SQTRNl,  or  $0TRN2. 

In  general,  before  calling  one  of  the  three  entry  points,  the  task 
must  have  the  address  in  register  RO  of  a  defined  area  (packet)  that 
is  within  the  task.  Also,  the  task  must  supply  in  the  packet  a  value 
for  B.LEN  and  B.TYP  (see  Section  17.6.2).  The  packet  contains  the 
header  and  the  information  that  is  to  be  written  as  a  transaction. 
The  action  taken  by  the  ACSUB  code  depends  on  the  entry  point  called 
by  the  privileged  task. 


17.5.1  Calling  $OTRAN 

The  SOTRAN  routine  automat Icall*,  fills  in  the  user-ID  fields  of  the 
packet  from  those  used  by  the  TI:  terminal  of  the  calling  task.  In 
effect,  this  shows  that  the  new  transaction  is  coming  from  the  same 
user  who  ran  the  task. 

To  call  this  entry  point,  the  task  must  have  the  addi'ess  of  the 
transaction  packet  in  register  RO.  The  two  fields  B.LL'  (containing 
the  transaction  length)  and  B.TYP  (f:;ontaining  a  transactio   -ode   iCrom 
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128  through  255)  roust  be  filled  in  and  contained  within  the  packet. 
SOTRAN  obtains  the  transaction  header  from  the  UAB  of  the  privileged 
task,  copies  the  header  except  for  B.LEN  and  B.TYP  into  ^he  packet, 
time-stamps  tha  packet,  and  links  the  packet  into  a  queue  to  be 
written  Into  the  transaction  file  by  the  SYSLOG  task.  SQTRAN  does  not 
alter  the  task's  space,  but  copies  the  packet  Into  secondary  pool 
space  before  copying  the  header  and  queuing  the  packet  into  the  SYSLOG 
queue. 

Example  17-1  Is  an  example  of  the  code  needed  to  call  SQTRAN. 
Example  17-1   Code  That  Calls  SQTRAN 

.HCAI.L  ACNDF* 

ACNPF*  (DEFINE  ACCOUNTING  SYHBOLS 

TRAN:  .BLMi       t.HLEN 


Thit  arc*  conliiris  cod*  tha\ 
d*tcrtb«4  th*  data  to  b* 
wriltrn  into  '.hr  1  rari»act  lori 
Tilt. 


nOV  tTRAN.RO  tGET  PACKET  AUDRESS 

MOy»  •ST .HOW.B. TYf'RO)  tflLL  IN  TYFt 

nOVIi  •l».t1LEN>ti.LEN(R0)  (FILL  IN  LENGTH 

CALL  »SHSTK.  ISUITCH  TO  StSTEh  STATt 

CALL  tPTKAN  MO  CALL  QUEUE  TRANSACTION  EXEC  ROUTINE 


17.5.2   Calling  SQTRNl 

The  SQTRNI  routine  allows  the  user-ID  fields  to  be  obtained  from  a 
specified  place.  Instead  of  assuming  the  current  task. 

To  call  this  entry  point,  the  task  must  have   filled   the   B.LEN  and 

B.TYP  fields  within   the   packet   and  must   have  the  address  of  the 

transaction  packet  in  register  RO.    In  addition,   register   Rl   must 

contain   an   APR   value   that  points  to  a  UAB  or  TAB  that  contains  the 

user-ID  data  that  should  be  copied  Into  this  transaction. 

The  intent  is  that  the  privileged  task  will  write  a  transaction 
associated  with  another  task.  SQTRNI  time-stamps  the  packet  and 
obtains  the  transaction  header  from  the  UAB  of  the  other  task.  SQTRNI 
then  queues  the  packet  In  the  SYSLOG  queue  to  be  written  into  the 
transaction  file.  SQTRNI  does  not  alter  the  packet  within  the  task, 
but  copies  identifying  information  from  the  specified  UAB  Into  the 
secondary  pool,  then  copies  data  Into  the  packet,  and  queues  the 
packet  Into  the  SYSLOG  queue. 
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Example  17-2  Is  an  axample  of  the  code  needed  to  call  SQTRNl. 


Example  17-2   Code  That  Calls  SQTRNl 


.nCALL    ACNDF* 
ACN[iF« 


•DEFINC  ACCOUNTING  SYnHOLS 


Thi*  vxanpl*  attij***  that  Rl  contain*  tht  rointvr 
to  the  TCB  of  tha  littk  for  which  tht  trantaction 
i»  to  ba  ^ottad. 


tran;  .dLKfi  [i.nLEN 


(START  OF  TRANSACTION 


dEQ 
HOV 


T.ACN(R1 > tRl 

10* 

•TRAN.RO 


IGET  OTHER  TASK  S  UAti  OF'  TAK  AMiRESS 
tIF  EO  NO  ACCOUNTING  DATA  PRESENT 
IF-OINT  TO  TRANSACTION  HERE 


HOVfi 
MOVS 
CALL 

CALL 


♦  BT.MOW.I'.TYF'(RO) 
•B.nLEN>B.LEN(RO) 
tSUSTK 

•OTRNl 


JFILL  IN  TRANSACTION  TYFE 
•FILL  IN  TRANSACTION  LENGTH 
•SWITCH  TO  SrSTEH  STATE 
»T0  CALL  EXECUTIVE  ROUTINES 


17.5.3   Calling  $QTRN2 

The  $0TRN2  routine  assumes  the  calling  task  completely  fills  in  the 
user-ID  area  of  the  transaction.  The  Executive  queues  the  packet  with 
no  modification,  except  for  a  time  stamp. 

To  call  this  entry  point,  the  task  must  have  the  address  of  the 
transaction  packet  in  register  RO.  $0TRN2  does  not  obtain  a  header 
from  any  other  source.  Therefore,  except  for  the  transaction  time, 
the  privileged  task  must  have  completely  filled  in  the  transaction 
header  and  the  transaction  data  contained  within  the  packet.  $QTRN2 
fills  in  the  transaction  time  field  in  the  transaction  header  area  of 
the  packet  created  by  the  user  task  and  queues  the  complete  packet  to 
the  SYSLOG  queue  to  be  written  to  th«(  transaction  file. 

Example  17-3  is  an  example  of  the  code  needed  to  call  $QTRN2. 

Figure  17-1  summarily  describes  the  privileged  task  interface  just 
discussed.  Section  17.6.2  contains  a  description  of  the  header  area 
fields. 


# 
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Example  17-3  Code  That  Calls  $0TRN2 


.HCALl     ACNDF* 
ACNI'Ft 


IbEFINE    ALC0UN11NG    STHBOLS 


TRAN!     .KLKIi    H.HLEN 


This    ttrvc    coritsint    th»    codp    th»t 
^••icribvs    the    h«<ij»r    trid    liii.t    to 
t>*    written    irito    the    t  r  jn*  act  ion 
file. 


noy  iiRAN.fco 

hOVH  ♦tr.flOV.P.  TTF  (RO' 

HOVff  »l«.«LENtp.l.ENtRO) 

nOV  UHifB.UIlMRO* 

HOV  uiii+:'.F<.uiti+2'.  fro> 

nOV  ACN«E<.ACN'  F.0> 

htiy  IIIuE.  THii  kO) 

CALL  «3USTK.     10* 

CALL  »qtkn: 

RETURN 


IfOINT     TO     TRANSACTION 

IFILL      IN     TRANSACTION     TtFt 

JFIIL      IN     TRANSACTION     LENGTH 

lUSER    SESSION     III 

ISECONli    HALF 

«ACti)lJNI     NUMUFF 

i  TERMINAL     III 

»':UITCM    TO    '.TiTEh    STATI 


■  1  0    USI  R 


10* 


17.6   ACCOUNT  BLOCKS 

There  are  two  types  of  Resource  Accounting  account  blocks:  the 
memory-resident  and  non-memory-resident  account  blocks.  The 
memory-resident  account  blocks  are  the  Task  Account  Block  (TAB) ,  the 
User  Account  Block  (UAB) ,  and  the  System  Account  Block  (SAB) .  The 
Task  Account  Block  (TAB)  accumulates  accounting  data  per  task  and 
stays  in  secondary  pool  as  long  as  a  task  is  active.  The  User  Account 
Block  (UAB)  for  each  logged-on  user  accumulates  the  Accounting  data 
and  stays  in  secondary  pool  as  long  as  the  user  is  logged  on.  The 
system's  UAB  accumulates  data  for  tasks  running  on  terminal  CO:.  The 
SAB  stays  in  secondary  pool  and  accumulates  system  accounting  data  as 
long  as  Resource  Accounting  is  running. 

All  other  account  blocks  are  non-memory-resident;  that  is,  they  are 
created  and  filled  when  any  transaction  occurs,  copied  by  Accounting 
into  secondary  pool,  and  immediately  written  into  the  transaction 
file,  and  the  space  is  deallocated  back  to  secondary  pool. 

All  of  the  blocks  have  a  header  area  that  contains  the  same  fields  and 
offsets.  In  addition,  the  TAB,  the  UAB,  and  the  SAB  have  data 
accumulation  field  areas  following  the  header.  All  data  accumulation 
fields  have  the  same  offsets.  The  information  specific  to  the  TAB, 
UAB,  and  SAB  follows  the  accumulation  areas. 
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Figure  17-1   Privileged  Task  Interface  Overview 
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You  can  find  the  size  and  the  description  of  the  offsets  in  Section 
17.6.2.  The  offsets  are  grouped  logically;  the  header  offsets  are 
described  in  one  group,  the  accumulation  field  offsets  in  another 
group,  and  so  forth.  The  account  and  transaction  block  diagrams  in 
Section  17.6.1  show  how  these  groups  fit  together  to  make  a  functional 
account  and  transaction  block.  The  account  and  transaction  block 
diagrams  are  shown  before  the  offset  descriptions. 

Check  the  [ 126, 101 ACNDF.DOC  file  on  the  distribution  kit  for  the 
correct  numeric  offsets  if  you  plan  to  write  a  program  that  uses  the 
offsets.  in  MACRO-ll  programs,  use  the  symbolic  names  defined  by  the 
ACNDFS  macro  in  ( 1 , 1] EXEMC.MLB.  The  names  will  not  change  even  if 
their  associated  offsets  change. 

NOTE 

The  UAB,  SAB,  mount,  and  print  despooler 
transaction  blocks  have  changed  for  this 
version  of  RSX-llM-PLUS.  An  analysis 
program  written  for  the  last  version 
will  require  modification  If  numeric 
field  offsets  were  used  instead  of  the 
symbolic  offsets  resolved  from  the 
ACNDFS  macro  or  EXELIB.OLB.  A  program 
can  distinguish  the  two  forms  of 
transactions  by  the  length  code. 
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17.6.1   Account  and  Transaction  Block  Dlagrama 
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17.6.2  Account  and  Transaction  Block  Offset  Definitions 

The  header  area  fields  precede  the  accumulation  fields  for  the  TAB, 
UAB,  and  SAB.  The  header  area  fields  also  precede  each  transaction 
block. 

The  header  provides  user  identification  by  two  fields  (B.UID  and 
B.ACN)  that  appear  in  every  transaction.  These  fields  are  the  unique 
session  identification  and  the  account  number.  The  unique  session 
identification  is  two  words  long.  The  first  word,  the  session 
identification.  Is  three  RAD50  characters  supplied  by  the  user  when  he 
creates  the  system  account  by  using  the  ACNT  program.  The  second  word 
is  a  unique  number  assigned  by  the  system  at  login.  Thus,  It  is 
possible  to  match  every  transaction  with  the  login  session  that 
produced  it.  The  account  number  field  is  a  binary  word  (entered 
through  ACNT)  that  is  copied  into  every  transaction.  Resource 
Accounting  does  not  use  either  of  these  fields,  except  to  ensure  that 
they  appear  in  every  transaction. 

Header  Area  Fields 

Size  or 
Offset  Value  Definition 

Start  of  header  area: 
B.LNK::  .BLKW  1  Link  to  next  In  SYSLOG  queue 

B.TYP::         .BLKB  1         Transaction  type: 

000  through  127  -  reserved  for  DIGITAL 

use 
128  through  255  -  reserved  for  customer 

use 
BT.SAB--1     System  Account  Block  (SAB) 
BT.UAB"2     User  Account  Block  (UAB) 
BT.TAB--3     Task  Account  Block  (TAB) 
BT.SS"««11     Account  I  i-i_,  startup  transaction 
BT.INV--12    Invalid  Ic-in  transaction 
BT.TIM--13    System  time  change  transaction 
BT.ALL*=14    Allocate  device  transaction 
BT.DEA--15    Deallocate  device  transaction 
BT.M0U-»16    Mount  device  transaction 
BT.DM0»»17    Dismount  device  transaction 
BT.PRT=-20    Print  despooler  transaction 
Reserved 
Reserved 
BT.L(X3-»23    Login  transaction 
BT.CRH--24    Crash  recovery  transaction 
BT.DST--25    Device  Statistics  (UCB  Extension) 
BT.RTP--26    Reset  Transaction  Parameters 
BT.INP--27    Card  Reader  Spooling  Transaction 

B.LEN::         .BLKB  1         Transaction  length  in  bytes 
B.TIM::         .BLKIV  3         Ending  time  of  transaction  (supplied  by 

SQTRAN, SQTRNl , $QTRN2) 

B.HID»=r,  Start  of  header  identification  area 

B.UID::         .BLKW  2         Unique  session  identification 

First  word  -  RAD50 

Second  word  -  binary 
B.ACN::         .BLKW  1         Account  number 
B.TID::         .BLKB  1         ASCII  terminal  type:  V  -  virtual, 

T  -  real,  B  -  batch,  C  -  console 
.BLKB  1         Unit  number 
B.HEND«=.  End  of  header  identification  area 
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Accumulation  Fields  for  User  Account  Block,  Task  Account 
Block,  and  System  Account  Block 


B.CPU 
B.DIR 

:                         .BLKW 
:                         .BLKW 

2 
2 

B.QIO 
B.TAS 

:                         .BLKW 

:                         .BLKW 

.BLKW 

2 
2 
3 

B.BEG 
B.CPUI 

:                         .BLKW 
.z:                      .BLKW 

3 
2 

B.PNT: 


B.STM:: 


.BLKW  1 


.BLKB  1 
BS.ACT--200 
BS.CRH--100 
BS.LGO--40 

BS.CO--40 
BS.TML--20 


BS.ZER" 10 
BS.SCN--4 


Total  CPU  time  used 

Total  directive  count 

Total  010$  count 

Total  task  count  (not  used  in  TAB) 

Reserved 

Beginning/login  time 

CPU  time  limit  in  TAB  or  UAB 

(not  used  in  SAB) 
Pointer  to  SAB  if  system  statistics 

to  be  collected.   Equals  0  if  no 

system  statistics  collection.   In  TAB 

this  points  to  UAB.   In  UAB  points  to 

SAB  if  SYSTEM-STATISTICSzYES  or  zero. 

In  SAB  always  zero. 
Status  mask 

Control  block  active  (UAB,  TAB) 

Record  from  TMP  file  after  crash  (UAB,  SAB) 

Logged  off  with  outstanding 

activities  (UAB  only) 

Tasks  TI:  is  CO:  (TAB  only) 

TAB  exists  only  for  time  limit  (TAB  only) 

TABS  with  this  bit  set  will  not 

be  written  to  the  transaction  bite. 
Last  CPU  interval  was  zero  length  (TAB,  UAB) 
Transaction  ready  for  write  to  scan  (UAB, 

SAB)  file 


User  Account  Block 


Note:   User  Account  Blocks  must  end  on  a  word  boundary, 


B.USE: 
B.ACT: 
B.UUIC 
B.UCB: 
B.LGO: 
B.ULNK 
B.RNA: 


B.NAM: 


B.ULEN= 


.BLKB  1 

.BLKW  1 

.BLKW  1 

.BLKW  1 

.BLKW  3 

.BLKW  1 

.BLKW  3 


.BLKB  14. 
.BLKB  1 
.BLKB  1 


Use  count 

Number  of  currently  active  tasks 

Login  UIC 

Pointer  to  UCB 

Logoff  time 

Link  to  next  User  Account  Block 

Location  in  system  account  file  - 
(offset,  VBN-hi,  VBN-lo) 
This  will  be  inacurate  if  the 
account  file  is  changed  (additions, 
deletions,  sorts). 

Last  name  of  user 

First  initial  of  user 

Unused  byte 

User  Account  Block  Length 
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Task  Account  Block 


NOTE; 


Task  Account  Blocks  must  end  on  a  word  boundary. 


B.PRI: ! 
B.TNAM! 
B.TCB: ; 
B.TST3! 

B.CUIC 
B.PUIC 
B.CTXT 
B.TCKP 
B.OVLY 
B.EXST 
B.TLEN 


BLKB 

1 

BLKW 

2 

BLKW 

BLKW 

BLKW 

BLKW 

BLKW 

BLKW 

BLKW 

BLKW 

2 

BLKW 

2 

Highest  running  priority 

Task  name 

TCB  address 

T.ST3  from  task's  TCB 

Reserved  for  future  status  bits 

Current  UIC  of  task 

Protection  UIC  of  task 

Number  of  context  loads 

Times  task  has  beet  checkpointed 

Number  of  disk  overlay  loads 

Exit  status  and  abort  code  Q 

TAB  length 

System  Account  Block 


B.SHDN: 


,BLKB  1 


B.UHD: 
B.UlO: 
B.ULT: 
B.CKP: 
B.SHF: 
B.RND: 


,BLKW 
BLKW 
BLKW 

.BLKW 
BLKW 
BLKW 


Accounting  shutdown  reason  code 

1  -  Maintenance 

2  -  Reboot 

3  -  Scheduled  shutdown 

4  -  Accounting  shutdown  by  Shutup 

task 

5  -  Other 

User  Account  Block  listhead 
Number  of  users  currently  logged  on 
Total  number  of  logons 
Total  number  of  checkpoints 
Total  number  of  shuffler  runs 
Number  of  CPU  intervals  rounded  up 
to  1/2 


O  The  abort  codes  are: 

S.CACT— 4.  Task  still  active 

S.CEXT--2.  Task  exited  normally 

S.COAD«0.  Odd  address  and  traps  to  4 

S.CSGF«2.  Segment  fault 

S.CBPT-4.  Break  point  or  trace  trap 

S.CIOT-6.  ICT  instruction 

S.CILI-8.  Illegal  or  reserved  instruction 

S.CEMT-10.  Non-RSX  EMT  instruction 

S.CTRP-12.  TRAP  instruction 

S.CFLT-14.  PDP-11/40  floating  point  exception 

S.CSST-16.  SST  abort-bad  stack 

S.CAST-18.  AST  abort-bad  stack 

S.CABO-20.  Abort  via  directive 

S.CLRF-22.  Task  load  request  failure 

S.CCRF-24.  Task  checkpoint  read  failure 

S.IOMG-26.  Task  exit  with  outstanding  I/O 

S.PRTY«28.  Task  memory  parity  error 

S.CPMD=30.  Task  aborted  with  PMD  request 

S.CELV-32.  TI:  virtual  terminal  was  eliminated 

S.CINS-34.  Task  installed  in  2  different  systems 

S.CAFF-36.  Task  aborted  due  to  bad  affinity  (required  by  runs  are 

offline  or  not  present) 

S.CCSM«38.  Bad  parameters  or  bad  stack 

S.COTL-40.  Task  has  run  over  its  time  limit 
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B.FID: : 

.BLKW 

B.DVNM! J 

.BLKB 

B.UNIT: J 

.BLKW 

B.EXTS: : 

•  BLKW 

B.LSCN: t 

.BLKW 

B.SCNR: J 

.BLKW 

B.DSCNt 1 

.BLKW 

.BLKW 

9. 

B.SLEN". 

File-ID  of  transaction  file 

Device  of  transaction  file 

Unit  of  transaction  file 

Extend  size  for  transaction  file 

Time  of  last  scan 

Scan  rate  in  seconds 

Device  statistical  scan  rate  (in 

seconds) 
Reserved 
System  Account  Block  lenqth 


SYSLOG  Startup  Transaction  Block 


B.SSLN--. 


Transaction  lenqth 


Set  Accounting  Transaction  Block 


B.OFID: : 

B . ODNM :  : 

B.OUNT: : 

B.NFID: 

B.NDNM: 

B.NUNT: 

B.OEXS: 

B.NEXS: 

B.OSCR: 

B.NSCR: 

B.ODSC: 

B.NDSC: 

B.RTLN-- 


.BLKW  3 

.BLKB  2 

.BLKW  1 

.BLKW  3 

.BLKB  2 

.BLKW  1 

.BLKW  1 

.BLKW  1 

.BLKW  1 

.BLKW  1 

.BLKW  1 

.BLKW  1 


File-ID  of  old  transaction  file 
Device  of  old  transaction  file 
Unit  of  old  transaction  file 
File-ID  of  new  transaction  file 
Device  of  new  transaction  file 
Unit  of  new  transaction  file 
Extend  size  for  old  transaction 
Extend  size  for  new  transaction 
Old  scan  rate  in  seconds 
New  scan  rate  in  seconds 
Old  statistical  scan  rate 
New  statistical  scan  rate 
Transaction  length 


file 
file 


Crash  Recovery  Transaction  Block 


B.CTLS: ! 
B.CSRT: : 
B.CRSN: : 
B.CLEN=». 


.BLKW  3 
.BLKW  1 
.BLKB  60. 


Time  of  last  scan  before  crash 
Scan  rate  before  crash 
ASCII  text  explaining  crash 
Transaction  length 


Invalid  Login  Transaction  Block 


B.INAM: : 
B.  lUIC: : 
B. IPSW: : 
B.  ILEN". 


.BLKB  14. 
,BLKB  6. 
.BLKB  6. 


Name  from  login  line 
UIC  from  login  line 
Password  from  login  line 
Transaction  length 


Device  Transaction  for  Disk  Accounting 
(ALLOCATE,  DEALLOCATE,  MOUNT,  and  DISMOUNT) 


B . DNAM ! 
B.DUNT: 
B.DLENs 


,BLKW  1 
.BLKB  1 


ASCII  device  name 
Octal  device  unit  number 
Transaction  length  for  ALLOCATE, 
DISMOUNT,  and  DEALLOCATE 


17-37 


B.DLBL:  i 
b.DMST: « 
B.DUIC:  t 
B.DVPR:  : 
B.DACP:  : 
B.MLEN--, 


B.TOLDt : 
B.TNEV/:  : 
B.TMLN--. 
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Only  Appear  for  MOUNT  Transactions 


.BLKB  1 
.BLKW  6 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  2 


Unused  byte 

Volume  label 

Mount  Status  Bits 

Owner  UIC 

Volume  protection  code  ^ 

Name  of  ACP  for  device 

Length  of  MOUNT  transactions 


System  Time  Change  Transaction  Block 


.BLKB  6 
.BLKB  6 


'r ,  mon,  day,  hr,  min,  sec) 
New  time  (yr,  mon,  day,  hr,  min,  sec) 
Transaction  length 


Old  time  (y 
New  time  (y 


Print  Despooler  Transaction  Block 


B.PNAM: : 
B.PPGS: : 
B.PNFI: : 
B.PFRM: : 
B.PPRI: : 
B.PDEV: : 
B.PPUN: : 
B.PLEN--, 


•BLKW  3 
.BLKW  1 
.BLKW  1 
•BLKB  1 
.BLKB  1 
.Bi^KW  1 
.BLKB  1 


Print  job  name  (RAD50) 

Page  count 

Number  of  files  printed 

Form  number 

Print  priority 

Print  device  name  (ASCII) 

Unit  number  of  print  device 

Transaction  length 


Card  Reader  Spooling  Transaction  Block 


B.RNAM: : 
B.RCDS: ! 
B.RDEV: ! 
B.RUNT: : 
B.RSOP: : 
B.RLEN-o. 


.BLKW  3 
•BLKW  1 
.BLKW  1 
.BLKB  1 
.BLKB  1 


Batch  or  print  job  name 
Number  of  cards  read 
Reader  device  name  iASCII) 
Unit  number  of  reader  device 
Submit  or  print  {0=SUBMIT,  1-PRINT) 
Transaction  length 


O  The  volume  protection  codes  are; 
Bits      Protection 


0-3 

system 

4-7 

owner 

8-11 

group 

12-15 

world 

The  bit  settings  within  each  protection  group  arei 
Bit    Access  denied  (if  bit  set) 


0 
1 
2 
3 


read 
write 
create 
delete 
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Login  Transaction  Block 


B.LUIC: : 
B.LNAM: : 

B.LLEN". 


.BLKW  1 
.BLKB  14. 
.BLKB  1 


Login  UIC 
User's  last  name; 
User's  first  initial 
Transaction  ler.gth 


The  following  globals  are  also  defined: 


B.MAXL--128. 
B.MINL--9. 


Maximum  transaction  length  (words) 
Minimum  transaction  length  (words) 


Device  Statistics  Block 


X.NAME 
X.IOC: 
X.ERHL 
X.ERSL 
X.ERSC 
X.ERHC 
X.WCNT 
X.CYLC 
X.CCYL 
X.FCUR 
X.FLIM 
X.DSKD 
X.DNAM 
X.UNIT 


X.LGTH" 


.BLKW  2 

.BLKW  2 

.BLKB  1 

.BLKB  1 

.BLKB  1 

.BLKB  1 

.BLKW  2 

.BLKW  2 

.BLKW  1 

•BLKB  1 

.BLKB  1 

•BLKB  1 

.BLKB  1 

.BLKB  1 


Drive  name 
I/O  Count 
Hard  error 
Soft  error 
Soft  error 
Hard  error 


in  RAD50 


limit 

limit 

count 

count 

Words  transferred  count 
Cylinders  crossed  count 
Current  cylinder 
Current  fairness  count 
Fairness  count  limit 
Disk  direction  (high  bit  1-out) 
Device  name  for  accounting 
Unit  number  for  accounting 
Unused 

Length  of  the  UCB  extension 
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17.6.3   Account  aiock  Llnkaqes 


SYSCM    I      tSABPT 


Tf 

TUCB 

T  ACN 

TCB 

TUCB 

T  ACN 

UCB 

o 

TTS 

UUAB 

SYSCM  SSYUAB 


Figure  17-2   Account  Block  Linkages 
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Tarminal  TT5:,  which  is  indicated  by  the  UCB,  is  that  of  the 
most  recently  logged-on  user.  The  aser  of  this  terminal  has 
started  two  tasks,  which  are  indicated  by  the  two  Task 
Control  Blocks  (TCB)  that  contain  pointers  to  the  UCB 
(T.UCB)  and  each  associated  TAB  (T.ACN) .  Each  TAB  then 
points  to  the  terminal's  UAB.  The  total  usage  of  terminal 
TTS:   is  totaled  in  the  associated  UAB. 


Terminal  TT7:  is  that  of  the  next  most  recently  logged-on 
user.  The  user  has  started  a  task  indicated  by  the  single 
TCB,  which  points  to  a  TAB  which  points  to  a  UAB.  The  total 
usage  of  terminal  TT7:   is  totaled  in  the  associated  UAB. 

The  CO:  console  terminal  has  associated  with  it  a  single 
TCB  that  indicates  a  system  task  is  running.  In  effect,  the 
system  is  also  a  user  and  has  system  usage  accumulated  at 
the  task  level  in  the  TAB  and  totaled  in  the  UAB  associated 
with  the  CO:   terminal. 


0 


The  SAB  contains  the  usage  totals  for  all  the  users 
including  the  system  Itself.  The  B.UHD  pointer  in  the  SAB 
points  to  the  UAB  of  the  most  recently  logged-in  user. 
B.UHD  and  the  B.ULNK  words  in  each  UAB  are  the  linkages  that 
are  used  when  Accounting  periodically  writes  the  UABs  to  the 
scan  file. 

The  pointer  to  the  SAB  (SSABPT)  is  in  the  Executive  module 
SYSCM. 

The  pointer  to  the  system  UAB  ($SYUAB)  is  In  the  Executive 
module  SYSCM. 


NOTE 

Although  all  active  UCBs  point  to  the 
appropriate  UABs  using  U.UAB,  this  is 
not  true  for  CO:.  U.UAB  does  not  exist 
for  CO:,  but  instead  is  reflected  by 
location  SSYUAB. 


17.7   SYSTEM  RESOURCES  USED 

The  following  sections  discuss  the  amount  of  system  space  that 
Resource  Accounting  uses.  Secondary  pool  usage  varies  from  a  certain 
minimum  to  an  amount  determined  by  the  number  of  logged-in  users  and 
event-associated  transactions. 


17.7.1   Executive  Space  Requirements 

Accounting  support,  whicJ  Is  a  SYSGEN  option,  takes   up   approximately 
532  words. 

Space  in  system  pool  is  required  for  one   active   task   and   one  open 
file. 
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17.7.2   Sacondary  Pool  Uaag* 

K«ch  logg«d-in  user  requires  two  blocks  (32  words  p*r  block)  of 
secondary  pool  for  the  User  Account  Block  (UAB) ;  that  is,  two  blocks 
for  each  logged-on  terminal  or  virtual  terminal.  Each  task  running  in 
the  system  requires  two  blocks  for  the  Task  Account  Block  (TAB),  if 
task  accounting  is  enabled.  Resource  Accounting  needs  two  blocks  for 
the  SAB  and  two  blocks  for  the  system  UAB.  Non-memory-resident  events 
such  as  device  mounts  require  one  block  for  a  brief  period  of  time. 


17.8   RESOURCE  ACCOUNTING  MESSAGES 

Accounting  messages  are  numbered  from  1(10)  through  79(10).  However, 
not  all  of  the  numbers  in  this  range  are  used.  The  number  appears  at 
the  start  of  the  Accounting  message.  The  Accounting  messages  have  the 
following  format: 

hh :  mm:  ss  aaaTnn  nn.   *aaaaaa*  message... 
where 
hh :  mm:  ss 

The  time  of  the  message  occurrence  is  hh:  mm:  ss 


aaaTnn 


nn. 


The  task  issuing  the  message  and  the  terminal  executing  the  task 
are  displayed  as  aaaTnn.  The  first  three  letters  of  the  task  are 
indicated  by  aaa.  Tnn  is  the  terminal  number  of  the  terminal 
executing  the  task.  SYSLOG  appears  if  the  message  originated 
from  that  task. 


The  message  number  is  nn.   The  message  number  enables  you  to  find 
a  description  of  the  message  in  the  following  list  of  messages. 


*aaaaaa* 


The  message  severity  code  is  aaaaaa  and  it  has  four  forms.  It 
may  not  be  present;  if  it  is  not,  the  message  is  an 
informational  message.   The  four  forms  of  the  severity  code  are: 

*DIAG*  -  Information  only 

•WARN*  -  Possible  error  condition 

♦ERROR*  -  Command  did  not  succeed 

♦FATAL*  -  Extreme  error  condition 
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Th«  following  is  a  list  of  th*  Accounting  messagss: 

nninninn  aaaTnr.  1.   Undefined  message  number  nn.   at  PC  aaaaaa 

Explanation!  The  message  number  is  a  decimal  number  specified  by 
nn.  The  location  is  specified  by  the  address  aaaaaa.  This  is  an 
internal  Accounting  error. 

User  Actioni   Submit  a  Software  Performance  Report  (SPR) . 

nn:nn:nn  aaaTnn  2.   Directive  error.   $DSW-nnn  PC  is  just  before  aaaaaa 

Explanation:  The  directive  error  code  is  an  octal  number 
specified  by  nnn.  The  PC  contains  an  address  just  preceding  the 
octal  address  aaaaaa.  This  message  provides  additional 
information  to  a  message  that  will  appear  with  it. 

User  Action:  Look  up  the  directive  error  code  in  the 
RSX-llM-PLUS  Mini-Reference  to  obtain  more  information. 

nn:nn:nn  aaaTnn  4.   PCS  aaa  ERROR  CODE  ^  nnn 
FILE:   DBn:   [???,???] filename. filetype;v 

Explanation:  The  word  "I/O"  or  "DSW"  is  specified  by  aaa.  The 
error  code  is  specified  by  nnn.  The  UIC  is  inaccessible  and 
appears  as  question  marks. 

User  Action:  An  explanation  of  the  error  code  can  be  found  in 
the  RSX-llM-PLUS  Mini-Reference. 

nn:nn:nn  aaaTnn  5.   *ERROR*  Illegal  filename 

Explanation;  The  file  name  specified  in  the  START/ACCOUNTING 
command  is  invalid. 

User  Action:   Correct  the  file  name  and  reenter  the  command. 

nn:nn:nn  aaaTnn  6.   *FATAL*  Can't  open  transaction  file 

Explanation:  The  transaction  file  could  not  be  created  for  the 
specified  reason.  The  specified  reason  is  in  the  message  that 
appears  with  this  one. 

User  Action:   Determine  the  cause  of  the  error  and  correct  it. 

nn:nn:nn  aaaTnn  7.   *FATAL*  Can't  open  transaction  file  (by  id) 

Explanation:  After  It  was  created,  the  transaction  file  became 
Inaccessible  for  the  specified  reason.  The  specified  reason  is 
in  the  message  that  appears  with  this  one. 

User  Action:  Issue  STOP/ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 
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nninntnn  aaaTnn  8.   *PATAL*  Can't  writ*  transaction  file 

Explanatlont  The  transaction  file  could  not  be  written  for  the 
specified  reason.  The  specified  reason  Is  In  the  message  that 
appoars  with  this  one.  Accounting  cannot  recover  from  this 
error.  Accounting  data  Is  lost  because  the  file  cannot  be 
written. 

User  Action!  Issue  STOP/ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  It,  and  restart  Accounting. 

nninninn  aaaTnn  9.   *ERROR*  Can't  close  transaction  file 

Explanation:  The  transaction  file  could  not  be  closed.  This 
error  cannot  be  recovered  from.  Accounting  data  Is  lost  because 
the  file  cannot  be  closed. 

User  Action:  If  possible,  determine  why  the  file  cannot  be 
closed.  Restart  Accounting  for  a  short  period  to  see  If  the 
error  recurs. 

nn:nn:nn  aaaTnn  10.   *FATAL*  Can't  inlt  new  blocks 

Explanation:  The  transaction  file  cannot  be  written  when  the 
file  Is  being  extended.  Accounting  cannot  recover  from  this 
error.  Accounting  data  Is  lost  because  the  file  cannot  be 
written  to  be  extended. 

User  Action:  Issue  STOP/ACCOUNTING  CLEANUP,  determine  the  cause 
of  the  error,  correct  It,  and  restart  Accounting. 

nn:nn!nn  aaaTnn  11.   *FATAL*  Can't  Inlt  n^w  blocks.   I/O  error  ■  nnn 

Explanation:  The  transaction  file  cannot  be  written  when  the 
file  is  being  extended.  Accounting  cannot  recover  from  this 
error.  Accounting  data  Is  lost  because  the  file  cannot  be 
written  to  be  extended. 

User  Action:  Issue  STOP/ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 

An  explanation  of  the  I/O  error  code  can  be  found  in  the 
RSX-llM/M-PLUS  Mini-Reference. 

nn:nn:nn  aaaTnn  12.   *FATAL*  Can't  write  attributes.   I/O  error  »  nnn 

Explanation:  The  transaction  file  cannot  be  written  when  the 
file  is  being  extended.  Accounting  cannot  recover  from  this 
error.  Accounting  data  is  lost  because  the  file  cannot  be 
written  to  be  extended. 

User  Action:  Issue  STOP/ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 

An  explanation  of  the  I/O  error  code  can  b^  found  In  the 
RSX-llM/M-PLUS  Mini-Reference. 
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nninntnn  aaaTnn  13.   *PATAL*  Can't  writ*  attributes 

Explanationt  Th*  transaction  file  cannot  be  written  when  the 
file  is  being  extended.  Accounting  cannot  recover  from  this 
error.  Accounting  data  is  lost  because  the  file  cannot  be 
written  to  be  extended. 

User  Action!  Issue  STOP/ACCOUNTING  CLEANUP,  determine  the  cause 
of  the  error,  correct  It,  and  restart  Accounting. 

nntnntnn  aaaTnn  14.   *FATAL*  Secondary  pool  allocation  failure 

Explanation:  There  is  insufficient  secondary  pool  remaining  to 
start  Accounting. 

User  Action:  Use  VMR  (Chapter  10)  to  Increase  the  secondary  pool 
partition  size,  and  reboot. 

nn:nn:nn  aaaTnn  15.   *FATAL*  Bad  SYSLOG  queue 

Explanation:  The  SYSLOG  task's  input  Is  not  empty  during 
Accounting  startup. 

User  Action:  Issue  STOP/ACCOUNTING  CLEAN_UP  and  restart 
Accounting . 

nn:nn:nn  aaaTnn  16.   *ERROR*  Accounting  already  active 
Explanation:   Accounting  is  already  active. 
User  Action:   None. 

nn:nn!nn  aaaTnn  17.   *FATAL*  Error  spawning  SYSLOG 

Explanation:  Tha  SYSLOG  task  could  not  be  started  due  to  the 
specified  reason  in  t'  e  message  that  appears  with  this  one. 

User  Action:  Determine  the  cause  of  the  error,  correct  it,  and 
restart  Accounting. 

nn:nn:nn  aaaTnn  18.   Accounting  system  not  started 

Explanation:  Accounting  was  not  started  due  to  the  specified 
reason  in  the  message  that  appears  with  this  one. 

User  Action:  Determine  the  cause  of  the  error,  correct  it,  and 
restart  Accounting. 

nn:nn:nn  aaaTnn  21.   SYSLOG  exit  with  status  ■  n. 

Explanation:  The  exit  status  of  the  SYSLOG  task  is  represented 
by  the  decimal  number  n.   See  the  accompanying  SYSLOG  message. 

User  Action:  Correct  the  problem,  if  there  is  one,  and  try 
again. 
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nntnntnn  aaaTnn  22.   *ERROR*  SYSLOG  not  Insi-allad 

Explanation!  The  SY3L0G  task  was  not  Installed  when 
START/ ACCOUNTING  was  specified. 

User  Actioni  Install  SYSLOG  and  reissue  the  START/ACCOUNTING 
command. 

nn:nn!nn  aaaTnn  23.   *ERROR*  Error  bit  set.   cleanup  before  restart. 

Explanation:  Accounting  had  an  error  and  cannot  be  restarted 
until  you  issue  the  STOP/ACCOUNTING  CLEAN_UP  command. 

User  Action:  Issue  the  STOP/ACCOUNTING  CLEAN_UP  command  and 
restart  Accounting. 

nn:nn:nn  aaaTnn  25.   •ERROR*  Accounting  did  not  crash 

Explanation:  A  STOP/ACCOUNTING  CLEAN_UP  command  was  issued 
unnecessarily. 

User  Action:   None. 

nn:nn!nn  aaaTnn  27.   ♦FATAL*  System  commanu  handling  error 

Explanation;   This  is  a  Get  MCR  command  line  directive  failure. 

User  Action:  The  AGO  task  was  RUN,  so  no  command  line  was 
queued.  Access  to  this  task  is  only  legal  with  the  specified 
Accounting  commands. 

nn:nn:nn  aaaTnn  28.   *ERROR*  Privilege  violation 

Explanation:  You  did  not  have  the  privilege  for  the  spe<  Ified 
operation. 

User  Action:  Nonpr Ivlleqed  users  can  see  the  Accounting  data  for 
their  terminal  only. 

nn:nn:nn  aaaTnn  29.   *ERROR*  Accounting  not  supported  In  system 

Explanation:  Accounting  cannot  be  used  unless  it  is  selected  as 
an  option  In  SYSGEN. 

User  Action:  Do  another  SYSGEN  and  select  Accounting  as  an 
option. 

nn:nn:nn  aaaTnn  30.   *ERROR*  Illegal  command  or  parameter 
Explanation:   The  entered  command  Is  Incorrect. 
User  Action:   Enter  the  correct  command. 
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nn:nntnn  aaaTnn  31.   *ERROR*  Commaitd  or  parameter  ambiquous 

Explanation:  Parameter  was  entered  with  too  few  letters  to  be 
uniquely  identified. 

User  Action:  Reenter  the  command  with  more  letters  in  the 
parameter . 

nn:nn:nn  aaaTnn  32.   *ERROR*  Syntax  error 

Explanation:   The  entered  command  is  incorrect. 
User  Action:   Enter  the  correct  command, 

nn:nn:nn  aaaTnn  33.   *ERROR*  Terminal  I/O  error 

Explanation:  A  terminal  I/O  error  occurred  during  a  prompt  or  a 
read  to  the  terminal. 

User  Action:   Try  the  operation  again. 

nn:nn:nn  aaaTnn  34.   *ERROR*  Repeated  or  contradictory  parameter 
Explanation:   Illegal  or  duplicate  parameter  combination. 
User  Action:   Enter  the  correct  command  parameter. 

nn:nn:nn  aaaTnn  35.   *ERROR*  Required  parameter  missing 

Explanation;   A  parameter  is  missing  in  the  command  line. 
User  Action:   Reenter  the  command  with  the  required  parameter. 

nn:nn:nn  aaaTnn  36.   *ERROR*  Value  out  of  range 

Explanation:  The  value  entered  was  either  too  large  or  too 
smal  . 

User  Action:   Reentar  the  command  with  the  correct  value. 

nn:nn:nn  aaaTnn  38.   *ERROR*  No  accounting  data  present 

Explanation:  The  terminal  specified  in  the  SHOW  ACCOUNTING/- 
INFORMATION  command  either  does  not  have  any  Accounting  data  or 
is  not  logged  in. 

User  Action:  Determine  the  correct  terminal  to  use  and  reenter 
the  command. 

nn:nn:nn  aaaTnn  39.   *ERROR*  Device  specification  error 

Explanation:  A  device  specification  was  entered  incorrectly  in 
the  command  line. 

User  Action:  Determine  the  correct  device  and  reenter  the 
command. 
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nn:nntnn  aaaTnn  40.   *PATAL*  No  startup  transaction  found 

Explanation:  Tha  START/ACCOUNTING  c^itmand  and  tha  SYSLOG  task 
are  closely  related  and  depend  upon  each  other  for  correct 
operation.  Any  attempt  to  start  the  SYSLOG  Accounting  task  by 
any  method  other  than  the  use  of  START/ACCOUNTING  results  In  this 
message. 

User  Action:  If  START/ACCOUNTING  and  SYSLOG  were  used  as 
Intended  and  this  error  resulted,  submit  an  SPR. 

nntnn:nn  aaaTnn  41.   •WARN*  Bad  transaction  length. 

Block (3)  of  secondary  pool  may  be  lost 

Explanation:  A  transaction  was  probably  too  large  or  too  small 
and  is  probably  a  user-designed  transaction. 

User  Action:  Correct  the  generation  of  the  transaction.  See 
B.MINL  or  B.MAXL  in  Section  17.6.2. 

nn:nn:nn  aaaTnn  42.   •ERROR*  UAB  Llsthead  not  zero  on  shutdown 
Explanation:   Internal  consistency  error. 
User  Action:   Submit  an  SPR. 

nn:nn:nn  aaaTnn  43.   *ERROR*  Transactions  follow  SAB 
Explanation:   Internal  consistency  error. 
User  Action:   Submit  an  SPR. 

nn:nn:nn  aaaTnn  44.   *FATAL*  UAB  Not  found  in  list 
Explanation:   Internal  consistency  error. 
User  Action:   Submit  an  SPR. 

nn:nn:nn  aaaTnn  45.   *FATAL*  Exiting  due  to  error 

Explanation:  SYSLOG  exited  for  the  specified  reason.  The 
specified  reason  is  in  the  message  that  appears  with  this  one. 

User  Action:  Issue  STOP/ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 

nn:nn:nn  aaaTnn  46.   *FATAL*  Transaction  not  in  secondary  pool 
Explanation:   Internal  consistency  error. 
User  Action;   Submit  an  SPR. 

nn:nn:nn  aaaTnn  47.   Exiting 

Explanation:   Normal  SYSLOG  exit  due  to  STOP/ACCOUNTING  commanO. 
User  Action:   None. 
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nninntnn  aaaTnn  50.   Accounting  not  running 

Explanation:  Tha  command  Issued  requires  Accounting  to  be 
running. 

User  Action!   Issue  START/ACCOUNTING  and  reissue  the  command. 

nn:nn:nn  aaaTnn  51.   *ERROR*  Accounting  had  a  fatal  error,  must  be  cleaned  up 
Explanation:   Accounting  failed. 
User  Action:   Issue  the  STOP/ACCOUNTING  CLEAN_UP  command. 

nn:nn!nn  aaaTnn  52.   *ERROR*  SYSLOG  Not  active 

Explanation:   SYSLOG  has  unexpectedly  exited. 

User  Action:  Issue  the  STOP/ACCOUNTING  CLEAN_UP  command  and 
restart  Accounting.  " 

nn:nn:nn  aaaTnn  53.   *ERROR*  Cannot  '-ilte  crash  transaction 

Explanation:  The  crash  transaction  could  not  be  written  to  the 
new  transaction  file  for  the  reason  specified  in  the  accompanying 
message.   The  crash  data  is  lost. 

User  Action;   None. 

nn:nn:nn  aaaTnn  54.   *ERROR*  Error  during  scan  file  rename 

Explanation:  The  specified  error  was  encountered  when  dealing 
with  the  scan  file. 

User  Action:   Determine  the  cause  of  the  problem  and  correct  it. 

nn:nn:nn  aaaTnn  55.   *ERROR*  On  scan  file  PUTS 

Explanation:  The  specified  error  was  encountered  when  dealing 
with  the  scan  file. 

Us«r  Action:   Determine  the  cause  of  the  problem  and  correct  it. 

nn:nn:nn  aaaTnn  57.   Please  enter  reason  for  the  crash  (maximum  60.   characters) 

Explanation:  This  is  the  prompt  for  the  user-supplied  crash 
reason  because  "yes"  was  answered  as  the  CRASH_REASON  parameter 
on  the  START/ACCOUNTING  command. 

User  Action:   Enter  a  crash  reason. 

nn:nn:nn  aaaTnn  58.   *ERROR*  Terminal  I/O  Error 

Explanation:  A  terminal  I/O  error  occurred  during  the  input  of 
the  crash  reason.   The  crash  information  is  lost. 

User  Action:   None. 
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nnmntnn  aaaTnn  60.   •ERROR*  lO  Error 

Explanation:   The  specified  I/O  error  occurred   during   the   SHOW 
ACCOUNTING  TRANSACTION  command. 

Usar  Action!   Correct  the   I/O  condition  and   try  the  command 
again. 

nninn:nn  aaaTnn  64.   *ERROR*  Illegal  file  name 

Explanation:   There  Is  an  Incorrect  file   specification   for   the 
SHOW  ACCOUNTING  TRANSACTION  command. 

Usar  Action:   Correct  the  file  specification  and  try  the  command 
again. 

nnmntnn  aaaTnn  65.   ♦ERROR*  Open  error 

Explanation:   The  specified  error  occurred   during   a   file  open 
procedure  of  the  SHOW  ACCOUNTING/TRANSACTION_FILE  command. 

User  Action:   Determine  the  cause  of  the  error,  correct   it,   and 
try  the  operation  again. 

nn:nn:nn  aaaTnn  70.   *ERROR*  On  scan  file  open 

Explanation:   The  specified  error  was  encountered  when  Accounting 
was  processing  the  scan  file. 

User  Action:   Determine  the  cause  of  the  problem  and  correct  it. 

nn:nn:nn  aaaTnn  71.   •ERROR*  On  scan  file  delete 

Explanation:   The  specified  error  was  encountered  when  Accounting 
was  processing  the  scan  file. 

User  Action:   Determine  the  cause  of  the  problem  and  correct  it. 

nn:nn:nn  aaaTnn  72.   •ERROR*  On  scan  file  close 

Explanation:   The  specified  error  was  encountered  when  Accounting 
was  processing  the  scan  file. 

User  Action:   Determine  the  cause  of  the  problem  and  correct  it. 

nn:nn;nn  aaaTnn  73.   *ERROR*  On  scan  file  open 

Explanation:   The  specified  error  was  encountered  when  processing 
the  scan  file. 

User  Action:   Determine  the  cause  of  the  problem  and  correct  it. 
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nn:nn:nn  aaaTnn  74.   *ERROR*  Copying  scan  file  to  trans  file 

Explanation!  The  specified  error  was  encountered  when  processing 
the  scan  file.  The  crash  Information  that  would  have  appeared  In 
the  transaction  file  Is  lost. 

User  Action:   None. 

nninninn  aaaTnn  75.   *ERROR*  On  scan  file  close 

Explanation:  The  specified  error  was  encountered  when  processing 
the  scan  file. 

User  Action:   Determine  the  cause  of  the  problem  and  correct  it. 

nn:nn:nn  aaaTnn  76.   •ERR.  ■".*  On  scan  file  delete 

Explanation:  The  specified  error  was  encountered  when  processing 
the  scan  file. 

Us«r  Action:   Determine  the  cause  of  the  problem  and  correct  it. 
nn!nn:nn  aaaTnn  79.   *ERROR*  Task  not  In  memory  or  not  active 
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CHAPTER  18 
RSX-llM-PLUS  SHADOW  RECORDING 


This  chapter  describes  Shadow  Recording,  how  to  prepare  your  system 
for  it,  and  how  to  control  it.  Shadow  Recording,  which  is  a  SYSGEN 
option,  is  an  Executive  feature  of  RSX-llM-PLUS  that  allows  your 
system  to  back  up  all  new  data  as  it  is  written  to  a  Files-11  disk. 

Shadow  Recording  creates  two  identical  sets  of  disks  called  a 
"shadowed"  pair.  More  than  one  pair  of  disks  may  be  shadowed,  but 
shadowed  disk  pairs  cannot  overlap.  The  first  disk  of  the  pair,  the 
primary  disk,  is  the  original  disk  that  exists  whether  or  net  Shadow 
Recording  is  active.  You  can  make  any  disk  on  youi  system,  including 
the  system  disk,  the  primary  disk  of  a  shadowed  pair.  By  using  the 
procedure  and  the  START  command  described  in  the  following  sections, 
the  second  disk  of  the  pair,  the  secondary  disk,  becomes  an  exact  copy 
of  the  primary  disk. 

The  START  command  invokes  a  Shadow  Recording  task  called  SHAddnn, 
where  ddnn  is  the  device  unit  of  the  primary  disk.  This  task  is  the 
"catchup"  task  that  copies  the  primary  disk  to  the  secondary  disk. 
Shadow  Recording  occurs  while  catchup  is  in  progress.  In  other  words, 
records  are  written  to  both  the  primary  disk  and  secondary  disk 
without  interfering  with  the  catcliup  process. 

After  you  issje  the  START  command.  Shadow  Recording  provides  a  dynamic 
backup  of  all  blocks  as  they  are  written  to  the  primary  disk.  Shadow 
Recording  has  important  uses  in  the  following  applications: 

1.  Duplicating  important  information  to  prevent  inadvertent 
damage  or  loss.  With  Shadow  Recording,  critical  data  is 
duplicated  on  two  disks.  This  redundancy  prevents  loss  of 
data  if  a  disk  error  occurs  and  therefore  may  provide  quicker 
recovery  time  in  critical  applications.  Also,  downtime  may 
be  reduced  because  disk  errors  do  not  necessarily  mean  an 
application  must  be  halted. 

2.  Providing  on-line  bacv-p  to  give  an  "instant"  duplicate  disk 
where  later  backup  tii  -^  or  resources  are  unavailable. 


The  Shadow  Recording  feature  operates  transparently  because  writing  t< 
and   reading   from  the   secondary  disk  is  an  Executive  function.   Th« 
Executive  always  writes  the  same  data  to  the  secondary  disk   the 
writes   to  the  primary  disk  when  Shadow  Recording  is  active.   Hov 


to 
le 
lat  it 
jwever, 
when  a  disk  read  occurs,  the  Executive  reads  the  primary  disk  first. 
If  a  read  error  occurs  on  the  primary  disk,  the  Executive  reads  the 
secondary  disk.  The  Executive  displays  all  I/O  eriors  occurring  on  a 
Shadow  Recording  disk  pair  on  the  operator's  console. 

You  can  use  five  commands  to  control  Shadow  Recording  (as  described  in 
Section  18.2).  The  START  command  copies  the  primary  disk  onto  any 
secondary  disk  of  the  same  device  type.   After  you  make  the  bad   block 
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InfuimaLion  idt-ntlcjl  and  then  use  the  START  command.  the  secondary 
disk  becomes  a  logical  duplicate  of  the  primary  disk.  Thir.  means  that 
all  copied  data  blocks,  bad  blocks,  headers,  directories,  and  so  forth 
occupy  the  same  logical  locations  on  the  secondary  disk  a;,  they  do  on 
the  primary  disk.  Further  action  on  your  part  is  unnecessary  unless 
you  want  to  stop  Shadow  Recording. 


18.1   PREPARING  YOUR  SYSTEM  FOR  SHADOW  RECORDING 

More  than  one  pair  of  disks  can  be  shadowed,  but  shadowed  pairs  cannot 
overlap.  For  example,  if  you  make  DBO:  and  DBl:  a  shadowed  pair, 
you  can  make  DB2:  and  DB3:  a  shadowed  pair  but  not  DBl:  and  DB2:. 
Additionally,  the  devices  must  be  of  the  same  type. 

Bjfore  you  can  use  a  pair  of  disk  drives  for  Shadow  Recording,  you 
must  have  available  two  identical  disk  packs.  The  two  disk  packs  must 
have  the  same  bad  block  data.  You  can  make  the  bad  block  data  on  the 
two  disks  functionally  equivalent  by  following  the  procedures 
discussed  next. 

In  the  following  procedure  the  assumption  is  made  that  you  will  shadow 
record  the  system  disk.  However,  the  procedure  is  valid  for  any  two 
devices  of  the  same  type.  To  get  ready  for  Shadow  Recording,  you  must 
perform  the  following  actions  for  each  shadowed  pair: 

1.  Shadow  Recording  Is  a  SYSGEN  option.  You  must  select  Shadow 
Recording  as  an  option  during  system  generation  before  you 
can  run  Shadow  Recording. 

2.  Determine  which  two  device  units  you  want  to  use  for  the 
shadowed  pair.  They  must  be  the  same  type  of  device,  for 
example,  two  RP06s  or  two  RM02s.  One  of  these  two  devices 
will  be  the  device  that  will  contain  the  primary  disk  that 
you  want  to  be  "shadowed."  The  other  will  contain  the 
secondary  disk. 

If  for  example,  your  system  has  four  RP06s  and  you  decide  to 
shadow  record  the  system  device,  DBO:,  you  can  select  one  of 
the  three  remaining  devices  as  the  secondary  device  of  the 
shadowed  pair:   DBl:,  DB2:,  or  DB3:. 

3.  Next,  gather  a  set  (three  or  more)  of  disks  that  you  can  use 
for  Shadow  Recording.  There  are  two  principles  involved  with 
the  selection  of  the  set  of  disks  for  Shadow  Recording: 

•  The  disks  being  used  for  Shadow  Recording  must  be 
logically  equivalent  (have  the  same  bad  blocks).  To  make 
the  disks  logically  equivalent,  you  select  one  disk  of  the 
set  as  the  primary  disk  and  make  Its  bad  block  descriptor 
block  a  logical  OR  of  all  the  bad  blocks  in  the  set  of 
disks.  Then,  when  you  start  Shadow  Recording,  the 
contents  of  the  primary  disk,  including  the  bad  block 
information,  is  copied  to  the  secondary  disk. 
Subsequently,  the  Executive  writes  the  same  data  to  the 
secondary  disk  that  it  writes  to  the  primary  disk. 
Because  the  bad  block  information  on  the  primary  disk  is 
an  OR  of  its  own  bad  blocks  and  those  of  the  secondary 
disk,  the  write  to  the  secondary  disk  does  net  occur  for  a 
defective  block. 

You  can  make  the  disks  logically  identical  by  making 
entries  in  the  bad  block  descriptor  block  of  the  primary 
disk  (see  step  4) . 
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•  You  can  use  another  disk  of  the  set  as  a  spare,  logically 
equivalent  disk  in  case  of  Hlsk  errors.  This  is  why  you 
should  have  selected  three  or  more  disks  for  your  set  of 
Shadow  Recording  disks.  Using  one  of  these  spare  disks 
enables  quick  recovery  from  possible  disk  errors  and 
decreases  downtime  in  critical  applications.  Srror 
recovery  is  discussed  in  Section  18.3. 

4.  Before  you  make  entries  in  the  bad  block  descriptor  block  of 
the  primary  disk,  run  the  Bad  Block  Utility  (BAD)  with  the 
/LI  switch  on  all  the  disks  In  the  set  of  Shadow  Recording 
disks.  BAD  locates  the  bad  blocks  and  lists  them  on  your 
terminal.  This  list  is  the  information  you  need  to  make  the 
bad  block  descriptor  block  on  the  primary  disk  the  logical  OR 
of  all  the  bad  blocks. 

Now  you  can  make  entries  in  the  bad  block  descriptor  block  of 
the  primary  disk  by  usin  the  INITVOLUME  command  with  the 
/BAD»(MAN]  keyword  as  follows: 

>INI  ddnn:/BAD=(MAN] 

After  you  enter  the  INITVOLUME  command,  it  prints: 

INI>LBN(S)- 

In  response  to  this  prompt,  you  can  then  type  from  the 
terminal  the  list  of  bad  blocks.  The  INITVOLUME  command  is 
described  in  the  RSX-llM/M-PLUS  MCR  Operations  Manual.  Also, 
this  bad  block  informa' ion  will  be  used  by  subsequent  INI, 
DSC,  or  BRU  operations  on  this  volume.  The  Disk  Save  and 
Compare  Utility  (DSC)  and  the  Backup  and  Restore  Utility 
(BRU)  are  described  in  the  RSX-llM/M  PLUS  Utilities  Manual. 

5.  Copy  the  data  from  your  system  disk  to  your  primary  disk. 
This  disk  becomes  the  primary  disk  and  your  new  system  disk 
for  Shadow  Recording. 

For  example,  if  you  want  to  shadow  record  your  system  disk, 
copy  }t  to  the  primary  disk.  After  this  is  done,  you  will 
have  two  system  disks  with  identical  data,  but  they  will  not 
be  identical  physically  because  of  the  bad  block  locations. 
The  new  system  disk  becomes  the  primary  disk  for  shadow 
recording. 

6.  Mount  as  foreign  one  of  the  previously  selected  disks  on  the 
secondary  device.   Use  the  following  MOUNT  command: 

>MOUNT  ddnn:/FOR 

Now  you  are  ready  to  begin  using  Shadow  Recording.  Shadow  Recording 
copies  ti.e  primary  disk  to  the  secondary  disk  when  you  start  Shadow 
Recording  by  using  the  START  command.  Thereafter,  all  write 
operations  to  the  primary  disk  also  are  duplicated  to  the  secondary 
disk. 

Both  disks  have  equivalent  logical  block  numbers  and,  in  the  case  of 
system  disks,  both  disks  are  bootable.  In  addition,  after  the  START 
command  is  issued,  the  secondary  disk  becomes  a  Files-11  format  disk 
because  the  START  command  makes  ?n  exact  copy  of  the  primary  disk  on 
the  secondary  disk. 
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18.2   CONTROLLING  SHADOW  RECORDING 

You  can  us*  five  commands  to  control  Shadow  Recording.  However,  you 
can  only  enter  these  commands  from  a  privileged  terminal.  The 
commands  allow  you  to  start,  stop,  abort,  or  continue  Shadow  Recording 
^nd  to  display  all  device  pairs  that  are  being  "shaaowed."  The  five 
commands  are: 

1.  START 

2.  STOP 

3.  ABORT 

4.  CONTINUE 

5.  DISPLAY 

You  may  enter  these  commands  on  one  line,  for  example: 

>SHAdo*f  START 
Or,  you  may  enter  the  command  on  two  lines,  for  example: 

>SHA 

SHA>START 
The  following  sections  describe  the  commands. 
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START 


18.2.1   START  Comnand 

The  START  command: 


Forma 


Verifies  that  the   primary  disk   is   a   Plles-11   device   and 
mounted 

Verifies  that  the  secondary  disk   is  mounted  as  a   foreign 
device 

Verifies   that   both   the   primary  and   secondary  disks  are 
identical  disk  types 

Sets  up  the   Shadow  Recording   data   structure   (UMB) ,   which 
starts  the  Shadow  Recording  task  within  the  Executive 

Starts  the  copying  of  the  primary  disk  to  the   secondary  disk 
(catchup) 


START  ddnn:  TO  ddxxi 

Parameters 

ddnn: 

The  primary  Files-11   device   that   is   to  be   shadowed   on   the 
secondary  Files-11  device. 

ddxx: 

The  secondary  device  that  is  to   be   the   shadowed   copy  of   the 
primary  device. 

If  new  data  is  written  to  the  primary  disk  after  Shadow  Recording  is 
Initiated  with  the  START  command,  Shadow  Recording  also  writes  the  new 
data  to  the  secondary  disk.  That  is,  when  a  write  occurs  on  the 
primary  disk.  It  also  occurs  on  the  secondary  disk.  However,  the 
secondary  disk  can  only  be  read  from  the  last  portion  that  has  been 
copied.  The  information  about  the  last  block  copied  is  in  the  UMB 
control  block.  A  fully  redundant  secondary  disk  does  not  exist  until 
catchup  has  completed. 
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STOP 


18.2.2   STOP  Command 

The  STOP  command  prevents  Shadow  Recording  from  continuing.  However, 
during  catchup,  the  STOP  command  cannot  stop  Shadow  Recording.  In 
fact,  if  you  Issue  the  STOP  command  during  catchup,  you  receive  an 
error  message. 

To  stop  Shadow  Recording  during  catchup,  use  the  ABORT  command  (see 
Section  18. 2. 3) . 

The  absence  of  outstanding  I/O  does  not  necessarily  mean  that  all  file 
activity  has  stopped.  You  must  make  certain  that  all  tasks  that  write 
records  to  the  shadowed  pair  have  stopped  to  enrure  the  integrity  of 
the  secondary  data  before  you  issue  STOP  or  ABORT. 

The  STOP  command: 

•  Verifies  that  the  primary  device  is  part  of  a  shadowed  pair 

•  Unlinks  the  UMB  data  structure,  if  no  outstanding  I/O   exists, 
thereby  stopping  the  Executive  from  Shadow  Recording 

•  Marks  the  data  structure  for  deletion  If  outstanding  I/O  does 
exist 

Format 

STOP  ddnn: 
Parameters 
ddnn: 

The  device  unit  of  the  primary  device 
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ABORT 


18.2.3   ABORT  Command 

The  ABORT  command   stops   Shadow  Recording   even   If   catchup  Is   In 
progress.   The  ABORT  command: 

•  Verifies  that  the  primary  disk  Is  part  of  a  shadowed  pair 

•  Aborts  catchup  if  it  is  in  progress  and  then  executes  a   STOP 
command 

Format 

ABORT  ddnn: 
Parameters 
ddnn: 

The  device  unit  of  the  primary  device 
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CONTINUE 


18.2.4   CONTINUE  Command 

The  CONTINUE  command  allows  you  to  restart  Shadow  Recording  on  the 
same  two  dinks  that  you  were  using  when  the  STOP  command  was  issued. 
The  CONTINUE  command  assumes  that  the  two  disks  are  physically  alike, 
and  it  does  no^  check  the  disks  for  equality.  You  must  be  sure  that 
no  writing  occurred  on  the  primary  or  secondary  disks  after  you  issued 
the  STOP  command. 

The  CONTINUE  command: 

Assumes  that  the  primary  and  secondary  disks  are  identical 

V»«rifies  that  the  primary  disk   is   in   Files-11   format   and 
mounted  properly 

Verifies  that  the  secondary  disk  is  mounted  foreign 

Verifies  that  both  disks  are  identical  device  types 

Sets  up  the  S'.iadow  Recording   data   structure,   which   starts 
Shadow  Recording  within  the  Executive 

Forma 


CONTINUE  ddnn:  TO  ddxx: 
Parameters 
ddnn: 

The  device  unit  of  the  primary  device 
ddxx: 

The  device  unit  of  the  secondary  device 


• 
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DISPLAY 

18.2.5   DISPLAY  Command 

The  DISPLAY  command  shows  all  shadowed  pairs. 

Format 

DISPLAY 

Entering  the  DISPLAY  command  causes  a  display  of  the   shadowed   device 
pairs  in  the  following  format: 

UMB  PRIMARY  SECONDARY 

xxxxxx      ddnn:  ddxx: 

xxxxxx 

T^e  address  of  the  UMB  control  block  for  Shadow  Recording.    This 
control  block  is  in  the  system  Executive  pool  space. 

ddnn; 

The  device  unit  of  the  primary  device 
ddxx : 

The  device  unit  of  the  secondary  device 
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18.3   BAD  BLOCK  HANDLING 

Except  for  the  START  command,  which  copies  the  primary  disk  to  the 
secondary  disk,  the  Executive  writes  the  data  from  a  task  buffer  to 
th'j  primary  disk  and  then  writes  it  from  the  task  buffer  to  the 
secondary  disk.  If  write  errors  occur  on  ore  of  the  disks,  you  may 
not  know  it  until  the  Executive  attempts  to  re<<d  the  block  in  error. 

To  be  notified  of  write  errors  as  they  occur,  you  can  run  Shadow 
Recording  with  write  check  for  both  disks  of  the  shadowed  pair.  The 
MCR  command; 

>SET  /WCHK=ddnn5 

enables  write  check  on  the  device  that  you  specify  in  ddnn:.  However, 
be  aware  that  a  write  check  of  every  write  operation  takes  more  time 
to  execute  thar  a  write  only. 

When  write  check  is  enabled,  the  Shadow  Recording  program  prints  the 
error  messages  on  the  console  terminal.  These  error  messages  consist 
of  device  and  logical  block  numbers  when  available. 

In  the  case  of  a  read,  the  Executive  reads  from  the  primary  disk 
first.  If  it  encounters  an  error  on  the  primary  disk,  it  reads  the 
same  record  from  the  secondary  disk.  It  is  extremely  unlikely  that 
both  disks  wo'. Id  develop  an  error  in  exactly  the  same  place.  However, 
if  they  do,  a  notification  of  read  errors  on  the  secondary  disk  means 
that  the  primary  disk  is  also  bad  in  the  same  location. 

If  read  errors  occur,  several  procedures  can  be  followed  as  discui-^.r' 
next. 


18.3.1   Errors  on  thu  Primary  Disk 

If  errors  occur  when  the  Executive  tries  to  read  from  the  primary 
disk,  the  Executive  then  tries  to  read  the  same  record  from  the 
secondary  disk.  You  are  notified  of  the  errors  by  a  message  on  the 
console  and,  at  this  point,  you  may  decide  to  let  your  task  continue. 
It  you  do  decide  to  let  your  task  continue,  be  aware  that  the  shadowed 
pair  are  no  longer  alike. 

If  you  decide  not  .o  let  your  task  continue,  stop  the  processing  task 
(or  tarks)  and  use  the  STOP  command  to  stop  Shadow  Recording.  The 
secondary  disk  contains  all  the  data  that  was  on  the  primary  disk, 
including  the  bad  block  record.  Use  the  secondary  disk  as  the  new 
primary  disk.  Designate  a  new  device  of  the  same  type  for  the  new 
secondary  disk.  Mount  the  new  secondary  disk  on  the  secondary  device 
as  foreign. 

After  mounting  the  old  secondary  disk  on  the  primary  device  as  the  new 

primary   disk,   issue  the  START  command.   The  START  command  causes  the 

copying  of  the  primary  disk  to  the  secondary  disk,  including  the  bad 
block  record. 


18.3.2  Errors  on  the  Secondary  Disk 

If  errors  occur  on  the  secondary  disk,  the  shadow  of  the  primary  data 
is  no  longer  valid.  Shadow  Recording  should  be  stopped,  a  new 
secondary  disk  should  be  mounted,  and  Shadow  Recording  restarted.  The 
catchup  task  will  then  copy  the  primary  disk  to  the  new  secondary 
d^sk. 
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18.3.3  Erro::8  on  the  Primary  and  Seconiary  Disk 

The  simultaneous  occurrence  of  bad  data  in  the  same  blocks  of  two 
different  disks  is  unlikely,  and  this  kind  of  error  is  not 
recoverable.  However,  whether  or  not  an  error  occurs  at  the  same  or 
different  places  on  both  disks,  the  only  recourse  is  to  stop  Shadow 
Recording  and  your  tasks.  Then,  select  a  new  •  rimary  disk  and  new 
secondary  disk,  mark  the  bad  block  information  on  the  new  primary  disk 
as  before,  and  copy  the  old  primary  disk  to  the  new  primary  disk. 

If  the  error  occurred  on  different  blocks  on  both  disks,  the 
previously  processed  information  can  be  salvaged  by  using  the  old 
primary  and  secondary  as  a  shadowed  pair  input  to  the  Backup  and 
Restore  Utility  (BRU) .  BRU  copies  all  the  data  that  is  on  the  input 
disk  and  writes  it  to  the  output  disk.  If  you  use  a  shadowed  pair  as 
input  to  BRU,  only  the  good  data  is  written  to  the  output  disk  because 
of  the  alternative  read  that  the  Executive  does  on  the  secondary  disk 
if  primary  disk  errors  occur. 

Using  BRU  will  not  give  you  a  new  primary  disk.  You  must  create  a  new 
primary  disk  from  the  output  of  BRU  as  discussed  in  Section  18.1. 

Information  about  how  to  use  BRU  is  in  the  RSX-llM/M-PLUS  Utilities 
Manual. 


18.4   SHADOW  RECORDING  MESSAGES 

hh:mm:ss  —  Handler  Error  code-nn.   on  ddnn: 
Shadow  Pair:   ddnn:   ddxx: 
Task:   xxxxxx 
Logical  Block:   nnn. 
Bytes  in  xfer:   nnn. 
File  ID:   n,n 
File  Name:   xxxxxx 
nn.   errors  lost  due  to  saturation. 

Explanation: 

hh :mm:ss 

The  time  in  hours,  minutes,  and  seconds  of  the  error 
code-nn. 

The  I/O  error  code  (decimal)  for  the  error 

I/O  error  codes  are  summarized  in  the  RSX-llM-PLUS  Mini 
Reference  Manual . 

File  ID 
File  Name 

The  File  ID  and  File  name  are  printed  only  when  they  can  be 
determined  at  the  time  of  the  error. 

nn.  errors  lest 

When  an  error  occurs  on  a  shadowed  disk,  the  Executive 
notifies  the  shadow  error  reporting  task  that  prints  the 
above  message  on  the  console  terminal.  The  Exoci  ve  stores 
the  information  about  the  error  in  pool  for  the  error 
reporting  task  to  pick  up  and  print. 
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If  a  number  of  errors  occur  rapidly,  pool  can  fill  up  with 
this  error  information  before  the  error  reporting  task  can 
process  it  and  there  may  be  no  pool  left  to  run  the  system. 
Therefore,  the  Executive  allows  only  a  certain  number  of 
errors  to  be  qieued  in  pool  at  one  time.  If  this  limit  has 
been  reached  and  more  errors  occur,  the  Executive  does  not 
process  them  (it  keeps  track  of  how  many  it  did  not 
procfccs).  This  message  tells  the  user  how  many  errors  were 
ignored  in  this  way.  "Saturation"  refers  to  pool  being 
saturated  with  as  many  error  messages  as  the  Executive  limit 
allows. 

This  message  is  only  printed  when  errors  have  not  been 
processed. 

User  Action:   See  Section  18.3,  Bad  Block  Handling. 

SHA  —  Abort  error 

Explanation:   This  message  occurs  if  the  Shadow  Recording  ABORT 
command  cannot  abort  Shadow  Recording  during  catchup. 

User  Action:   Wait  until  catchup  terminates  and   then   issue   the 
STOP  command. 

SHA  -•■  Bad  indirect  file  specification 

Explanation:   The  indirect  command  file  name  is  incorrect. 
User  Action:   Reissue  the  indirect  command  file  specification. 

SHA  —  Bad  volume  type 

Explanation:   The  disk  is  not  in  Files-11  format  or   the  primary 
and  secondary  devices  are  different  device  types. 

User  Action:   Check  the  command  line   or  devices   that   you   are 
trying  t"  use. 

SHA  —  Catch-up  completed 

Explanation:   This  is  an  information  message.   The   primary  disk 
has  been  completely  copied  to  the  secondary  disk. 

User  Action:   None. 

SHA  —  Catch-up  in  progress 

Explanation:   You  have  tried  to  issue  a  STOP  command   during   the 
catchup  process. 

User  Action:   Issue  an  ABORT  command   if   catchup   is   still   in 
progress. 

SHA  —  I/O  error  on  logical  block  nnn. 

Explanation:   An  I/O  error  occurred  during  catchup. 

User  Action:   None.   If  the  I/O  errors  are   frequent,   enter   the 
ABORT  command,  change  disks,  and  restart  Shadow  Recording. 
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SUA  —  Illegal  command 

Explanation:  The  command  that  you  entered  is  not  a  legal 
command. 

User  Action:   Reenter  the  command. 

SHA  --  Input  error  on  input  command  file 
FILE= 

Explanation:  An  error  occurred  while  the  indirect  command  file 
was  being  read. 

User  Action:  Take  appropriate  action;  for  example,  use  a 
different  indirect  command  file,  or  use  a  copy  of  the  specified 
command  file. 


SHA  —  Illegal  parse  data  (internal  error) 

Explanation:   This  is  an  internal  system  error.   The  command   was 
correctly  entered. 

User  Action:   Reenter  the  command. 

SHA  —  Invalid  device 

Explanation:   The  device  is  not  a  disk  device. 

User  Action:   Check  the  device  specification  and  the  device. 

SHA  —  Maximum  indirect  command  file  depth  exceeded 

Explanation:   The  indirect  command  file  was  nested   to   too  many 
levels.   Only  three  levels  are  allowed. 

User  Action:   Check  the  indirect  command  file. 

SHA  —  No  room  available  for  UMB 

Explanation:   Not  enough  pool  space  exists  to  allocate  space   for 
the  UMB  control  block  for  Shadow  Recording. 

User  Action:   Check  your  system.   The  system  may  be  on  the  verge 
of  running  out  of  pool  space. 

SHA  —  Not  a  shadowed  pair 

Explanation:   When  STOP  or  ABORT  war.  issued,  the  wrong  device  was 
specified. 

User  Action:   Reissue  the  command  with  the  correct  device  unit. 

SHA  —  Open  error  on  input  command  file 
FILE= 

Explanation:   The  input  command  file  could  not  be  found. 
User  Action:   Check  the  command  file  and  its  location. 
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SHA  —  Privileged  command 

Explanation:   You  are  not  using  a  privileged  arcount  or  terminal. 
User  Action:   Log  in  on  a  privileged  account  or  terminal, 

SHA  —  Send/Receive  error 

Explanation:   A  RECEIVE  Executive   directive   error   occurred   In 
Shadow  Recording  during  catchup. 

User  Action:   None.   This  is  a  system  error. 

SHA  —  Shadow  Recording  not  in  system 

Explanation;   Shadow  Recording  is  not  part  of  your  system. 

User  Action:   Shadow   Recording   must   be   specified   at   system 
generation. 

SHA  —  Start-up  error 

Explanation:   Shadow  Recording  cannot  spawn  the  catchup  task,   so 
Shadow  Recording  exits. 

User  Action:   Restart  Shadow  Recording. 

SHA  —  Syntax  error 

Explanation:   The  entered  command  has  incorrect  syntax. 
User  Action:   Reenter  the  command. 

SHA  —  System  error 

Explanation:   A  system  error  occurred. 

User  Action:   Determine  the  effects  of  the  error  if  possible. 

SHA  —  Unknown  command  error 

Explanation:   Shadow  Recording  received  a  command   line   that   it 
could  not  recognize. 

User  Action:   Check  the  command  that  you  entered  or  the   indirect 
command  file. 

SHA  —  Volume  currently  part  of  shadowed  pair 

Explanation:   The   specified   device   is   already   being    shadow 
recorded. 

User  Action:   Check  the  devices  being  shadowed  with   the   DISPLAY 
command. 
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SHA  —  Volume  not  mounted  properly 

Explanation:   The  primary  device  is  not  mounted  Files-11   or   the 
secondary  device  is  not  mounted  foreign. 

User  Action:   Check  the  devices  and  mount  them  properly. 
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APPENDIX  A 
SERIAL  DESPOOLER  TASK 


Th<>  Serial  Despooler  Task  (PRT...)  provides  a  means  of  eliminating 
contention  for  the  system  line  printer.  Rather  than  waiting  for  the 
line  printer  to  become  available,  f>  task  directs  the  output  intended 
for  the  line  printer  to  a  disk  file.  The  task  issues  a  Send  Data 
directive  to  the  serial  despooler,  placing  a  data  block  that 
identifies  the  file  to  be  spooled  in  the  serial  despooler  queue.  A 
Request  directive  is  then  issued  by  the  task  to  activate  the  serial 
despooler,  in  case  it  is  not  already  active.  PRT  handles  FCS-created 
files,  but  RMS  files  can  be  read  only  if  they  are  sequential.  All 
files  identified  in  the  serial  despooler  queue  are  printed  in 
f irat-in-first-out  (FIFO)  order. 

You  may  wish  to  compare  the  capability  of  this  task  with  the  RSX-llM 
Queue  Metnager  and  its  associated  despooler.  See  Chapter  7  for  more 
information  about  the  Queue  Manager. 


A.l   RECEIVE  QUEUE  OPERATION 

The  standard  method  of  placing  a  user  file  in  the  serial  despooler 
receive  queue  (and  requesting  its  execution)  is  via  the  PRINTS  macro 
call,  which  is  described  in  the  IAS/RSX-11  2/2  Operations  Reference 
Manual.  Files  are  spooled  in  this  same  manner  by  the  RSX-11  utilities 
that  support  the  spool  (/SP)  option.  Each  entry  in  the  serial 
despooler  receive  queue  consists  of  a  13-word  data  blocK  containing 
the  file-related  information  illustrated  in  Figure  A-1. 


A. 2   TEXT  REQUIREMENTS 

The  serial  despooler  task  prints  ASCII  text  with  a  maximum  line  length 
of  132  bytes.  It  will  properly  handle  files  with  all  modes  of  FCS 
carriage  control  (that  is,  standard,  embedded,  and  FORTRAN). 


A. 3   TASK-BUILD  INFORMATION 

Tne  serial  despooler  task  must  be  built  during  an  RSX-llM  system 
generation  because  the  task  image  file  (PRT.TSK)  is  not  distributed  on 
the  standard  release  kits.  Normally,  the  serial  despooler  is  built  to 
retain  all  files  that  have  been  spooled,  but  the  serial  despooler 
build  file  can  be  edited  during  system  generation  to  enable  the 
automatic  delete  feature.  (Note  also,  that  a  nondeleting  despooler 
can  be  made  to  delete,  if  the  data  block  mentioned  in  Section  B.l  and 
shown  in  Figure  A-1  has  a  negative  value  in  word  7.)  When  the  serial 
despooler  is  built  without  automatic  delete,  spooled  files  are 
retained  after  printing.  It  the  system  has  a  deleting  serial 
despooler,  all  spooled  files  are  deleted  after  printing. 


SERIAL  DESPOOLER  TASK 


See  the  System  Generation  and  Management 
generation  ITiTormatlon. 


Guide   for   devailed   system 


WORD 
1 
2 
3 
4 
5 

7 
8 
9 

10 
11 
12 
13 


File  name 
in 

RADIX-50 


File  type  in  RADIX-50 


File  version  (binary) 


Device  name  in  ASCII 


Unit  number  (binary) 


File  ID 


Directory  ID 


Figure  A-1   PRT  Send  Data  Buffer  Format 


The  serial  despooler  is  set  to  spool  files  to  LPO:.  It  uses  LUN3  as 
the  spool  device.  The  system  manager  can  redirect  print  files  to  any 
record-oriented  device  (that  is,  a  device  similar  to  the  printer)  by 
reassigning  LUN3.  See  the  RSX-llM/M-PLUS  MCR  Operations  Manual  for 
information  on  the  REASSIGN  command. 


A. 4   PRT  ERROR  MESSAGES 

All  error  messages  issued  by  PRT  are  sent  to  the  console  terminal  via 
pseudo-device  CO:.   The  error  messages  have  the  following  format: 

PRT  —  text 

In  all  but  the  receive  failure  error,  the  messages  supply  information 
that  identifies  the  sender  task  and  the  file  in  question.  All  PRT 
errors  are  fatal;  upon  error  detection,  printing  of  the  input  file  is 
terminated,  and  a  cleanup/restart  procedure  is  entered. 

In  the  case  of  the  receive  failure  error,  the  sender  and  file 
information  are  unavailable.  Furthermore,  PRT  does  not  attempt  to 
dequeue  additional  spool  requests  because  of  the  nature  of  this  error 
condition.  Instead,  PRT  exits  causing  its  receive  queue  to  be  purged 
by  the  system. 
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RECEIVE  FAILURE,  d.  —  TASK  EXITING 

Explanation:  The  Receive  Data  or  Exit  directive  failed  while 
attempting  to  obtain  the  next  file  specifier  from  the  queue.  The 
system  error  code  (d.)  is  printed  to  idantify  the  error. 

NO  DEVICE  NAME  -  SENDER:  task  FILE:  f i lename . typ; ver 

Explanation:  The  dequeued  print  request  did  not  contain  a  device 
name. 

NO  FILE  ID  -  SENDER:  task  FILE:  f i lename. typ; ver 

Explanation:   The  dequeued  print  request  did  not  contain  a   file 

ID. 

OPEN  FAILURE  INPUT  FILE  -  SENDER:  task  FILE:  f i lename. typ; ver ,  d. 

Explanation:  The  specified  file  could  not  be  opened.  One  of  the 
following  conditions  may  exist: 

1.  The   file   is   protected   against   access   for   read 
privileges. 

2.  A  problem  exists  on  the  physical   device   (for  example, 
device  cycled  down) . 

3.  The  volume  is  not  mounted. 

4.  The  specified  file  directory  does  not  exist. 

5.  The  named   file  does  not   exist   in   the   specified 
directory. 

6.  The  file  is  already  deleted. 

The  system  error  code  (d.)  is  printed  to  identify  the  failure. 
ATTACH  FAILURE  -  SENDER:  task  FILE:  fi lename. typ; ver ,  d. 

or 

DETACH  FAILURE  -  SENDER:  task  FILE:  filename. typ; ver ,  d. 

Explanation:  The  line  printer  could  not  be  attached/detached 
(that  is,  the  system  does  not  contain  a  line  printer).  The 
syf.tam  error  code  (d.)  is  printed  to  identify  the  error. 

PRINT  ERROR  -  SENDER:  task  FILE:  filename. typ; ver ,  d. 

Explanation:  A  Queue  I/O  request  to  the  line  printer  has  failed. 
The  system  error  code  (d.)  is  printed  to  identify  the  error. 

I/O  ERROR  INPUT  FILE  -  SENDER:  task  FILE:  filename. typ; ver ,  d. 

Explanation;  An  error  was  detected  while  reading  the  input  file. 
One  of  the  following  conditions  may  exist: 

1.  A  problem  exists  on  the  physical   device   (for   example, 
device  cycled  down) . 

2.  Length  of  the  text  line  is  greater  than  132  bytes. 

3.  File  is  corrupted  or  the  format  is  incorrect. 

The  system  error  code  (d.)  is  printed  to  identify  the  error. 
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d.  LINES  WERE  TRUNCATED 

Explanation:  While  printing  the  file  PRT  truncated  d.   lines. 
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RSX-llM/M-PLUS  UFD  CONVENTIONS 


The  RSX-llM  and  RSX-llM-PLUS  operating  systems  observe  a  set  of  User 
File  Directory  (UFD)  conventions  for  files  on  disk.  These  conventions 
provide  a  consistent  method  of  locating,  allocating,  and  maintaining  a 
file  on  disk. 

A  UFD  is  itself  a  file,  named  in  the  format  gggmmm.DIR  where  g  and  m 
are  octal  numbers  in  the  range  1  through  377  (0  is  reserved).  The 
numbers  represent  the  file  owner's  group  and  member  number 
respectively.  For  more  information  on  file  ownership  and  directories, 
see  the  RSX-llM/M-PLUS  MCR  Operations  Manual  and  the  RSX-llM/M-PLUS 
Command  Language  Manual . 

The  usage  of  certain  UFDs  is  common  to  both  operating  systems;  other 
UFDs  are  specific  to  the  RSX-llM  or  RSX-llM-PLUS  operating  systems. 
The  following  sections  describe  group  and  member  numbers  and  their  use 
in  identifying  the  contents  of  system  UFDs.  A  section  on  file  naming 
conventions  is  also  included. 


B.l   GROUP  NUMBER 

The  group  number  identifies  groups  of  directories.  By  convention, 
group  numbers  1  through  200  are  reserved  by  DIGITAL  for  system  files 
and  group  numbers  201  through  377  are  reserved  for  user  files.  The 
group  numbers  may  vary  between  RSX-llM  and  RSX-llM-PLUS.  Table  B-1 
lists  the  group  numbers  and  their  usage. 


Table  B-1 
Group  Number  Identification 


Group 

Number 

Usage 

11 

Executive  files 

12 

MCR  files 

13 

FCP  files  (RSX-llM-FLUS) 

14 

RMD  files 

15 

Privileged  utility  tasks 

23 

DCL  files 

25 

Queue  Manager  files 

(continued  on  next  page) 
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Table  B-1  (Cont.) 
Group  Number  Identification 


G 

roup  Number 

Usage 

27 

On-line  configuration  (RSX-llM-PLl/S) 

45 

K-Series  files 

50 

FCS  files 

121 

Line  printer  despooler  (RSX-1 IM-PLUS) 

125 

Shadow  Recording  (RSX-llM-PLUS) 

126 

Accounting  tasks  (RSX-llM-PLUS) 

200 

SYSGEN  Indirect  command  files 

B.2   MEMBER  NUMBER 

The  second  number  (member  number)  identifies  the  different  file   types 
within  each  group.   Table  B-2  lists  the  member  numbers. 


Table  B-2 
Member  Number  Identification 


Member  Number 

File  Types 

10 

Source  modules 

20 

Object  modules,   assembly  and   cask-build 
command   files,  and  object  module  libraries 
for   RSX-llM   nonpr ivileged   tasks   and 
RSX-llM/M-PLUS  build  files 

24 

Object   modules,   :issembly   and   task-build 
command   files,  and  object  module  libraries 
for  the  RSX-1 IM/M-PLUS   Executive   and   for 

privileged   and   nonpr ivileged   tasks  on 
RSX-llM-PLUS 

30 

RSX-llM  unmapped   system   listing   and   map 
files   for   privileged   and   nonpr ivileged 
tasks. 

34 

RSX-llM-PLUS   and   RSX-llM   mapped    system 
listings   and   map  files  for  privileged  and 
nonpr ivileged  tasks. 

40 

SLP  correction   files   for   files   located 

under  member  number  10 

50 

RSX-llM   unmapped   system   image  and   task 

image  files 

(continued  on  next  page) 
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Table  B-2  (Cont.) 
Member  Number  Identification 


Member  Number 

File  Types 

54 
60 

64 
200 

RSX-llM-PLUS   and   RSX-llM  mapped   system 
image  and  task  image  files 

RSX-llS   unmapped   system    SLP   and    PPT 
correction   files  applied  by  Autopatc'i,  and 
system  image  and  task  image  files 

RSX-llS  mapped  system  image  and  task   image 
files 

SVSGEN  indirect  command  files 

B.3   EXAMPLE  SYSTEM  USER  FILE  DIRECTORIES 

The  system  UFDs  are  composed  of  a  group  number  and  a  member  number. 
Thet.e  numbers  identify  the  specific  contents  of  each  directory.  For 
example,  if  you  wanted  to  locate  all  the  MCR  listing  and  map  files, 
you  could  find  the  group  number  for  MCR  files  (12)  and  the  member 
number  tor  listing  and  map  files  (34)  and  combine  them  to  specify  the 
UFD  [12,34];  this  UFD  contains  the  MCR  listing  and  map  files. 
Table  B-3  lists  the  MCR  UFDs  and  the  files  contained  in  each  UFD. 
Table  B-4  lists  the  UFDs  used  by  the  RSX-llM/M-PLUS  operating  system. 


Table  B-3 
MCR  User  File  Directories  (UFDs) 


[12,10] 
[12,20] 

[12,24] 

r  1  •)  pm 

[12,34] 
[12,40] 


MCR  source  files 

Unmapped  MCR  object  modules,  assembly 
command  files,  and  library  build  command 
file 

Mapped  MCR  object  modules,  assembly  command 
files,  jnd  library  build  command  file 

Unmapped  MCR  listing  and  map  files 

SLP  correction  files  for  files  under 
[12,10] 


Table  B-4 
System  UFDS 


[1,-1 
[1,2] 


System  and  macro  object  module  libraries 
System  messane  and  help  files 


(continued  on  next  page) 
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Table  B-4  (Cont.) 
System  UPDS 


U,31 

Lost  files  found  by  VFY 

(1,41 

Postmortem  and  snapshot  dumps 

(1,61 

Error  logging  files  and,   on  RSX-1 IM-PLUS, 

Accounting 

(1,71 

Spooling  queue  file  and  transparent  listing 

file 

(1,11] 

RSX-llM-PLUS   work   space   for    system 

maintenance 

(1,201 

nSX-llM   object   nodule   libraries   and 

task-build  overlay  descriptor   files   for 

nonpr Ivlleged  tasks 

(1,241 

Object  module  libraries,  task-build  command 

files   for   mapped   tasks,   and   overlay 

descriptor  files  for  privileged  tasks 

(1,341 

Executive  and  task  maps 

(1,54] 

Executive  and  system  tasks 

(2,3001 

UETP  files 

(200,11 

Sample  files  for  system  introduction 

(200,21 

Field  service  files 

B.4   SYSTEM  PILE  NAMING  CONVENTIONS 

Syste,.  file  names  have  the  following  general  format: 

nrnsss.typ 

V  »re: 

nnn  Is  the  system  Identification  for  the  task.  For  example, 
DMP  is  the  identification  for  the  File  Dump  Utility 
Program. 

••■  is  a  suffix  for  noting  the  relationship  of  the  file  to 
the  task  specified  in  the  nnn  identification.  For 
example,  PIPBLD.CMD  Is  the  command  file  for  building  PIP. 

Suffixes: 

ASM  Assembly  command  file 

ELD  Task  Builder  command  or  overlay  descriptor  file 

RES  FCSRES  version  of  the  task 

FSL  FCSFSL  version  of  the  task  (RSX-llM-PLUS) 

typ  Is  the  standard  mnemonic  for  file  type.  RSX-1 IM/M-PLUS 
has  a  set  of  conventional  and  default  file  types  that  are 
used  to  reflect  the  contents  of  a  file.   See  Table  B-5. 
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Table  B-5 
System  File  Types 


Type 


File  Contents 


.BAS  BASIC-11  language  source  file 

.BAT  Batch  file 

.BLD  Indirect  command  file  used  as  input  to  SYSGEN 

.B2S  BASIC-PLUS-2  language  source  file 

.CBL  COBOL  language  source  file 

•CDA  Crash  dump  binary  fi  " 

.CFS  Error  logging  control  file  string 

.CLB  Indirect  Command  Processor  command  file  library 

.CMD  Indirect  command  file 

.COR  SLP  correction  file 

•CRF  Cross-Ref erence  Processor  symbol  table  file 

•DAT  File  containing  data  (as  opposed  to  a  program) 

.DIR  Directory  file 

.DMP  File  Dump  Utility  output  file 

.ERR  Error  Logger  output  file 

.FTN  FORTRAN  IV,  FORTRAN  IV-PLUS  or  FORTRAN  77  language 
source  file 

.HLP  Help  file 

•LOG  Batch  or  console  log  file 

•LST  Listing  file 

.MAC  MACRO-11  source  file 

.MAP  Task  Builder  memory  allocation  map 

.MLB  Macro  library  file 

•OBJ  Object  module  (output   from   either   the   MACRO-11 
Assembler  or  a  compiler) 

.ODL  Task  Builder  overlay  descriptor  file 

•OLB  Object  module  library  file 

.PAT  PAT  Utility  Correction  file 

.POB  Patched  object  module  used  by  the  PAT  Utility 


(continued  on  next  page) 
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Type 


.SML 
•  STB 
.SYS 
.TMP 
.TSK 
.TXT 
ULB 


Table  B-5  (Cont.) 
System  Pile  Types 


File  Contents 


System  macro  library  file 

Task  symbol  table  file 

Bootable  system  image  or  other  system  file 

Temporary  file 

Task  image  file 

Text  file 

Universal  library  file 
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$AB 

predefined  syntax  element  in 
MML,  12-45 
/ABAUD  keyword 
SET  command 
VMR,  10-46 
ABORT  command 
lOX,  4-23 

Shadow  Recording,  18-7 
Access 
device 

disabling,  15-18 
enabling,  15-21 
Account  entry 

adding  to  account  file,  2-3 
contents,  2-1 
deleting,  2-7 

r.ittering  information  in,  2-3 
examining,  2-4 
listing,  2-6 
modifying,  2-5 
Account  file 

adding  entry  to,  2-3 

copying,  2-2 

creating,  2-2 

extending,  2-2 

maximum  number  of  entries, 

2-2 
protection,  2-2 
sorting,  2-8 
Account  File  Maintenance 
Program 
See  ACNT 
ACNT 

account  file 
copying,  2-2 
extending,  2-2 
changing  password,  2-2 
copying  account  file,  2-2 
ESCAPE  key,  2-3 
invoking,  2-1 
option 
Add,  2-3 
create,  2-2 
Delete,  2-7 
Examine,  2-4 
Exit,  2-8 
List,  2-6 
Modify,  2-5 
Sort,  2-8 
protection 

restoring,  2-2 
ACSUB,  17-18 
Activity  report 

lOX,  4-19  to  4-21,  4-41 


Add  option 

ACNT,  2-3  to  2-4 
Adding  commands 

DCL,  12-9  to  12-11 
Address 
CSR 

changing,  10-12,  15-24 
interrupt  vector 

changing,  15-24 
vector 

changing,  10-12 
Address  space 
MSCP  disks 

relevant  to  RCT,  5-2 
/AFF  keyword 

INSTALL  command 

VMR,  10-21 
SET  command 
VMR,  10-46 
Alarm 

sanity  timer 

enabling,  15-24 
ALARM  option 
SET  command 
CON,  15-24 
$ALF 

predefined  syntax  element  in 
MML,  12-40 
$ALFN 

predefined  syntax  element  in 
MML,  12-40 
$ALL 

predefined  syntax  element  in 
MML,  12-43 
ALL  keyword 

DISPLAY  command 

CON,  15-10 
OFFLINE  command 

CON,  15-19 
ONLINE  command 
CON,  15-21 
Allocate  Device  Transaction 

Block,  17-29 
Allocation  failure 

pool,  13-2 
ALTER  command 

VMR,  10-8 
Alternate  CLI,  12-2 
AND  macro 

MML,  12-25  to  12-26 
ASN  command 
VMR,  10-9 
ASSIGN  command 
VMR,  10-9 

command  line  format,  10-9 


Index-1 


INDEX 


ASSIGN  command  (Cont.) 
VMR  (Cont.) 

example,  10-10 
keyword 

/GBL,  10-9 
ASSIGN/QUEUE  command 

DCL,  7-8,  7-12,  7-22 
Assignment 

logical  device,  10-9 
logical  unit  number 
changing,  10-32 
displaying,  10-29 
Attribute 

DCL  syntax  element,  12-25 
ATTRIBUTES  keyword 
DISPLAY  command 
CON,  15-10 
Autobaud  detection  option, 
10-46 

$BA 

predefined  syntax  element  in 
MML,  12-45 
Backup  and  Restore  Utility 

See  BRU  utility 
Backwards  deletion  option, 

10-48 
Bad  block 
detection 

RCT,  5-3 
handling 

Shadow  Recording,  18-10 
handling  on  MSCP  disks 

RCT,  5-3 
listing 

lOX,  4-25 
notification 

RCT,  5-3 
recovery 

RCT,  5-1 
removing  from  testing 

lOX,  4-24 
replacement 

RCT,  5-1,  5-3 
replacement  completion 

RCT,  5-4 
revectoring 

RCT,  5-4 
specifying 

lOX,  4-24 
steps  to  replace 
RCT,  5-3 
Bad  Block  Replacement  Control 
Task 
See  RCT 
BADB LOCKS 

display  command,  4-25 
lOX  command,  4-24 
parameter  command,  4-24 
Batch  processing,  7-1,  7-9  to 

7-10 
Batch  processor  prototype  task, 
7-1 


Baud  rate 

remote  terminal 

specifying,  10-57 
specifying,  10-59 
BC  macro 

MML,  12-26 
BCT  macro 

MML,  12-27  to  12-28 
Block 
bad 

detection 

RCT,  5-3 
handling  on  MSCP  disks 

RCT,  5-3 
listing 

lOX,  4-25 
notification 

RCT,  5-3 
recovery 

RCT,  5-1 
removing  from  testing 

lOX,  4-24 
replacement 

RCT,  5-1,  5-3 
replacement  completion 

RCT,  5-4 
revectoring 

RCT,  5-4 
specifying 

lOX,  4-24 
steps  to  replace 
RCT,  5-3 
incomplete  replacement 
checking 
RCT,  5-1 
logical 

RCT,  5-2 
replacement 

RCT,  5-2 
replacement  functions  listed 
RCT,  5-1 
$BNUM 

predefined  syntax  element  in 
MML,  12-40 
/BOOT  keyword 
SAVE  command 
VMR,  10-40 
/BOT  keyword 
SET  command 
VMR,  10-47 
/BRO  keyword 
SET  command 
VMR,  10-48 
Broadcast  option,  10-48 
BRU  utility 

creating  new  primary  disk, 

18-11 
procedure  for  Shadow 
Recording,  18-3 
BS  macro 

MML,  12-26 
BST  macro 

MML,  12-27  to  12-28 
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/BUF  keyword 
SET  command 
VMR,  10-48 
Buffer  space 
statistics 

shown  with  PARAMETERLIST, 
4-42 
BUFFERSIZE  command 

lOX,  4-26 

BUILD  command 

CON,  15-7 

command  line  format,  15-7 
example,  15-7 
Bus  run 
swi  tched 

connecting,  15-16 
disconnecting,  15-27 
switching,  15-26 


...CA.,  12-3 
Cache  corruption 
write-back 

checking  by  RCT,  5-1 
Cache  data 
write-back 

preventing  loss  of,  5-5 
$CALLOV 

predefined  syntax  element  in 
MML,  12-45 
CAN  command 

VMR,  10-11 

CANCEL  command 

VMR,  10-11 

command  line  format,  10-11 
example,  10-11 
Card  Reader  Spooling 

Transaction  Block,  17-33 
Catchall  fask,  12-3 
Catchup 

Shadow  Recording,  18-1 
CBM  macro 

MML,  12-28 
CCBM  macro 

MML,  12-28 
Character 
lowercase 

converting,  10-51 
Checkpointing 

dynamic  common  regions,  14-3 
static  common  regions,  14-3 
tasks,  14-3 
/CKP  keyword 

INSTALL  command 
VMR,  10-21 
CLZr R  command 
CO',  15-8 

ommand  line  format,  15-8 
example,  15-8 
/CLI 

keyword 

INSTALL  command 
VMR,  10-22 


CLI,  11-1,  11-3  to  11-4 

adding  to  account  entry,  2-3 

alternate,  12-2 

changing,  2-5 

contained  in  account  entry, 

2-1 
continuation  lines,  11-8 
displaying,  2-4 
example,  11-10  to  11-20 
FORTRAN,  11-15  to  11-20 
MACRO-11,  11-10  to  11-15 
Executive  directives,  11-3 
installing,  10-22 
interaction  with  system,  11-3 

to  11-4 
MCR,  2-3 
multi-CLI  support,  2-1,  2-3, 

2-5 
prompting,  11-7  to  11-9 
removing,  10-35 
serial  command  processing, 

11-9 
system  messages  to,  11-5  to 

11-7 
task  names,  11-4 
writing,  11-3 
COLOG 

stopping 

using  SHUTUP,  8-4,  8-6 
Command 
DCL 

adding  to,  12-7,  12-9  to 

12-11 
definition,  12-7,  12-9  to 

12-11 
deleting  from,  12-12 
modifying,  12-12 
tables,  12-6  to  12-12, 

12-17  to  12-20,  12-46 
to  12-47 
line 

VMR,  10-4 

comment  in,  10-5 
MCR 

testing  in  UETP,  9-3 
multiple 

for  Console  Logger,  3-6 
name 

VMR,  10-4 
parameter 

VMR,  10-4 
VMR 

summary,  10-5 
Command  Line  Interpreter 

See  CLI 
Comment 

VMR,  10-5 
Common 

directive 

fixing,  10-19 
removing,  10-34 
loading,  10-20 
partition,  14-1 


Index- 3 


INDEX 


Common  (Cont.) 

protecting,  10-23 
region 

fixing,  10-19 
read-only 

specifying,  10-24 
task 

sharing,  10-25 
unfixing,  10-74 
COMPAREDATA  YES/NO  command 

lOX,  4-27 
CON  command 

VMR,  10-12 
CON  program,  15-1 
command 

BUILD,  15-7 
CLEAR,  15-8 
DISPLAY,  15-9 
ESTATUS,  15-12 
HELP,  15-14 
IDENT,  15-15 
line,  15-4 
LINK,  15-16 
LIST,  15-17 
OFFLINE,  15-18 
OFFLINE  MEMORY,  15-20 
ONLINE,  15-21 
ONLINE  MEMORY,  15-23 
SET,  15-24 
summary,  15-5 
rwiTCH,  15-26 
UNLINK,  15-27 
error  message,  15-36 
invoking 

indirect  command  file,  15-4 
interactively,  15-4 
switch,  15-6 
task-build  time 

displaying,  15-15 
version  number 

displaying,  15-15 
Configuration 

of  devices  in  lOX,  4-28 
system 
device 

adding,    15-21 
removing,    15-18 
duplicating,    15-7,    15-17 
information 

displaying,  15-9 
memory  box 

adding,  15-23 
remo  ing,  15-20 
CONFIGURATION  command 
VMR,  10-12 

command  line  format,  10-12, 

10-14 
example,  10-13,  10-15 
keyword 

CONTROLLERS,  10-12 
CPU,  10-12 
CSR,  10-15 
PULL,  10-12 


CONFIGURATION  command  (Cont.) 
VMR 

keyword  (Cont.) 
UNITS,  10-12 
VEC,  10-15 
CONFIGURE  command 

lOX,  4-28 
Console 
driver 

loading  of,  3-2 
log  assignment 

displaying,  3-4 
logging 
command 

descriptions  of,  3-3 
general  format  of,  3-4 
summary  of,  3-3 
multiple  commands,  3-6 
session 

example,  3-9 
starting,  3-4 
stopping,  3-5 
output 

device,  3-1 

active  Console  Logger, 

3-1 
as  a  pseudo  device,  3-1 
as  affected  by  REDIRECT, 

3-1 
control  of  I/O,  3-1 
determining,  3-7 
MCR  REDIRECT  restriction, 

3-8 
redirecting,  3-7 
redirecting  with  MCR 

REDIRECT,  3-8 
status  of,  3-7 
device  I/O 

controlled  by  Console 
Logger,  3-2 
task,  3-1 

communication  withl,  3-2 
installed  by  SYSGEN,  3-2 
selecting  in  SYSGEN,  3-2 
terminal 

attaching  to,  3-3 
detaching  from,  3-3 
disabling,  3-5 
displaying  assignment,  3-4 
reading  from,  >-3 
reassigning,  3-5 
task  communication  to,  3-2 
writing  to,  3-2 
Console  Logger,  3-1 

aborting  restriction,  3-5 
communication  with,  3-2 
communication  with  a  task, 

3-2 
console  output  device  affect 

on,  3-1 
controlling  I/O  to  CO:,  3-2 
effect  when  active,  3-1 
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Console  Logger  (Cont.) 

error  messages  from,  3-11  to 
3-13 
Continuation  line 

CLI,  11-8 
CONTINUE  command 

Shadow  Recording,  18-8 
Control 

lOX  command 

category,  4-3 
RCT  table 

revector  status  code,  5-2 
Control  and  status  register 

See  CSR 
CONTROL_C  command 
lOX 

effect  on  CTRL/C,  4-31 
CONTROL  C  YES/NO  command 

lOX,  1-31 
Controller 
device 
failure 

recovering,  15-3" 
information 

displaying,  15-9 
placing 

off  line,  15-18 
on  line,  15-21 
status  flag 

displaying,  15-9 
memory  box 
information 

displaying,  15-9 
CONTROLLERS  keyword 
CON  command 

VMR,  10-12 
DISPLAY  command 
CON,  15-9 
$COP 

predefined  syntax  element  in 
MML,  12-43 
COP  macro 

MML,  12-29 
$COSEP 

predefined  syntax  element  in 
MML,  12-44 
CPU  keyword 
CON  command 
VMR,  10-12 
Crash  reason 

Resource  Accounting,  17-8 
Create  option 

ACNT,  2-2 
/CRT  keyword 
SET  command 
VMR,  10-48 
$CSEP 

predefined  syntax  element  in 
MML,  12-44 
CSR 

address 

changing,  10-12,  15-24 
option 


CSR  (Cont.) 

option  (Cont.) 
SET  command 
CON,  15-24 
CSR  keyword 
CON  command 
VMR,  10-15 
/CTB  keyword 
LOAD  command 
VMR,  10-27 
CTRL/C  command 

lOX,  4-30 
$CUIC 

predefined  syntax  element  in 
MML,  12-45 


$DATE 

predefined  syntax  element  in 
MML,  12-42 
Date 

displaying,  10-72 
setting,  10-72 
$DATE1 

predefined  syntax  element  in 
MML,  12-42 
DCL,  7-1,  7-12  to  7-13,,  11-2, 
11-i,  11-8,  12-1 
adding  commands,  12-7,  12-9 

to  12-11 
command 

definition,  12-9 
tables,  12-6,  12-46  to 
12-47 
deleting  commands,  12-12 
inst   lation,  12-1  to  12-3 
mapp  ig  to  MCR,  12-20  to 

12-25,  12-34 
master  command  table,  12-6  to 
12-12,  12-17  to  12-20, 
12-46  to  12-47 
modifying  commands,  12-12 
operations,  12-4  to  12-5 
parser  table,  12-6  to  12-12, 
12-17  to  12-20,  12-46  to 
12-47 
SYSGEN,  12-2 
taskbuilding,  12-4 
translator  table,  12-6  to 
12-12,  12-17  f  12-20, 
12-46  to  12-4/ 
$DDR 

predefined  syntax  element  in 
MML,  12-43 
Deallocate  Device  Transaction 

Block,  17-30 
DEASSIGN/QUEUE  command 

DCL,  7-22 
DECnet 

node  name 

displayed  by  SHUTUP,  8-2 
UIC 

specifying,  10-53 
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DECnet  Remote  Terminal  Facility 

See  RMT 
DECtape 

exercising 
lOX,  4-3 
Delete  option 

ACNT,  2-7 
DELETE/PROCESSOR  command 

DCL,  7-20  to  7-22 
DELETE/QUEUE  command 

DCL,  7-19  to  7-20 
/DENS  keyword 
SAVE  command 
VMR,  10-40 
Density 
tape 

in  lOX,  4-32 
DENSITY  command 

lOX,  4-32 
DESELECT  command 

lOX,  4-34 
Despool  prototype  task,  "^-l 
Despoolet 

error  h^^jsage,  A-2 

purpose  of,  A-1 

receive  queue  operation,  A-1 

send  data  buffer  format,  A-2 

system  generation  infunoi'itinn, 

A-2 
task-build  information,  A-1 
text  requirements,  A-1 
$DEV 

predefined  syntax  element  in 
MML,  12-42 
DEV  command 

VMR,  10-16 
$DEVE 

predefined  synta   element  in 
MML,  12-42 
Device 
access 

disabling,  15-18 
enabling,  15-21 
adding,  15-21 
buffer  size 

specifying,  10-48 
context,  15-3 
CSR  address 

changing,  15-24 
dismounting,  8-4,  6-6 
failed 

testing,  15-33 
faulty 

isolating,  15-30 
I/O  request 

redirecting,  10-33 
infornation 

displaying,  10-16 
interrupt  vector  address 

changing,  15-24 
lOX 

add  i  ng 

to  be  tested,  4-28 


Device  (Cont.) 
lOX  (Cont.) 
displaying 

those  tested,  4-28 
exercising 

steps,  4-2 
status 

during  exercise,  1-58 
testing 

removing,  4-34 
time  of,  4-55 
paging,  10-51 
placing 

off  line,  15-3,  15-18 
on  line,  15-3 
pseudo 

console  output,  3-1 
public 

specifying,  10-57 
removing,  15-18 
state,  15-2 

marked  for  off-line,  15-3 
marked  f c  r  on-line,  l[;-3 
off-line,  15-3 
on- line.  15-2 
status 

emitting,  15-12 
syA«-am  default 

adding  to  account  entry, 

2-3 
changing,  2-5 
contained  in  account  entry, 

2-1 
displaying,  2-4 
unit 

failure 

recovering,  15-31 
information 

displaying,  15-9 
placing 

off  line,  15-18 
on  line,  15-21 
status  flag 

displaying,  15-9 
write  checking 

specifying,  10-65 
DEVICE  command 

RMD,  6-12 
Device  controller 
failure 

recovering,  15-31 
information 

displaying,  15-9 
placing 

off  line,  15-18 
on  line,  15-21 
status  flag 

displaying,  15-9 
Device  driver 
loading,  10-27 
unloading,  10-75 
Device  name 
logical 


Index-6 


INDBX 


Device  nan*  (Cont.) 
logical  (Cont.) 

assigning,  10-9 
syabolic 

displaying,  10-16 
Dsvica  Statistics  Block,  17-33 
Device  statistics  example 

Resource  Accounting,  17-8 
DEVICES  coamand 
VMR,  10-16 

command  line  format,  10-16 
example,  10-16 
Diaomostic 

program,  15-33 
Diagnostic  Loader 

See  DLD 
Dialog 
UETP 

example,  9-7 
DIGITAL  Command  Language 

See  DCL 
/DIR  keyword 
FIX  command 
VMR,  10-19 
DIR  macro 

MML,  12-30 
Directive  common 
fixing,  10-19 
removing,  10-34 
Disk 

address  space 

RCT,  5  2 
block 

random  or  sequential 

lOX,  4-49 
testing  range  display 

lOX,  4-50 
testing  range  for  NFS 
volumes 
lOX,  4-50 
device  exercise  example 
an  RL02 

lOX,  4-9 
NFS  volume 
lOX,  4-14 
dual- port 
placing 

off  line,  15-3,  15-18 
on  line,  15-22 
exercising 
lOX,  4-2 
Files-11 

parameter  commands  for 

lOX,  4-8 
testing  for 
lOX,  4-63 
I/O  Queue  Optimization 

specifying,  10-53 
MSCP 

bad  block  handling 
RCT,  5-3 
testing 

selecting  random  testing 


Disk  (Cont.) 
testing 

selecting  random  testing 
(Cont.) 
lOX,  '•.-49 
skipping  blocks 
lOX,  4-40 
Dismount  Device  Transaction 

Block,  17-31 
Display 
lOX 

bad  blocks  list,  4-25 
commands  as  a  category,  4-3 
continuing 

with  PROCEED,  4-48 
DISPLAY  command 
CON,  15-9 

command  line  format,  15-9 

example,  15-10 

keyword 

ALL,  15-10 
ATTRIBUTES,  15-10 
CONTROLLERS,  15-9 
FULL,  15-9 
UNITS,  15-9 
wildcard,  15-10 
Shadow  Recording,  18-9 
DLD,  15-33 

command  line  format,  15-34 
example,  15-35 
DNAP  macro 

MML,  12-31  to  12-34 
$DNUM 

predefined  syntax  element  in 
MML,  12-40 
$DONUM 

predefined  syntax  element  in 
MML,  12-40 
Driver 
device 

loading,  10-27 
unloading,  10-75 
$DSB 

predefined  syntax  element  in 
MML,  12-43 
Dynamic  common  region 
checkpointing,  14-3 
shuffling,  14-5 
Dynamic  storage  region 
See  Pool 

/EBC  keyword 
SET  command 
VMR,  10-48 
/ECHO  keyword 
SET  command 
VMR,  10-49 
Echo  option,  10-49 
$EDR 

predefined  syntax  element  in 
MML,  12-44 
Eight-bit  character  option, 
10-48 


Index-7 


IMDIX 


$BOL 

predefined  syntax  element  In 
NKL,  12-43 
ERR  nacro 

NML,  12-30 
ERRLOG 
stopping 

using  SHUTUP,  8-4,  8-6 
Error 

hard,  15-29 

recovering,  15-30 
intermittent 

recovering,  15-30 
nonrecoverable,  15-29 
recoverable,  15-29 
soft,  15-29 
transient 

recovering,  15-30 
uncorrectable 

recovering,  15-32 
Error  limit 
altering 
lOX,  4-35 
Error  Logger 

relationship  to  RCT,  5-5 
Error  message 

See  also  Message 
CON,  15-36 

Console  Logger,  3-11  to  3-13 
despooler,  A-2 
HRC,  15-38 
lOX,  4-66 
RMD,  6-13D 
UETP,  9-5 
VMR,  10-76 
Error  report 
data  compare 

lOX,  4-21 
directing  to  device 

lOX,  4-41 
disabling 

lOX,  4-52 
enabling 

lOX,  4-52 
I/O  error 

lOX,  4-21 
types 

lOX,  4-52 
UETP,  9-4 
ERRORLIMIT  command 

lOX,  4-35 
$ESB 

predefined  syntax  element  in 
MML,  12-43 
ESCAPE  key 

requesting  list  of  options 
ACNT,  2-3 
Escape-sequence  recognition 

option,  10-49 
/ESCSEQ  keyword 
SET  command 
VMR,  10-49 


ESTATUS  coMnand 
CON,    15-12 

example,  15-13 
Event 
pool 

affecting  pool  condition, 

13-3 
detecting,  13-1 
extreme  fragmentation,  13-1 
to  13-4,  13-7  to  13-10, 
13-12 
general  fragmentation,  13-2 

to  13-4 
major,  13-1  to  13-3 
Event  flag 

use  in  lOX,  4-64 
Examine  option 

ACNT,  2-4  to  2-5 
EXECUTE  command 

lOX,  4-36 
Execution 
termination 
of  task 
lOX,  4-23 
Execution  mode 
entering 

lOX,  4-59 
lOX,  4-18 
Executive 
module 

CORAL. MAC,  13-2  to  13-3 
pool  monitor 

code,  13-1,  13-12 
interface,  13-2  to  13-3 
swapping 
length 

specifying,  10-61 
priority  range 

specifying,  10-61 
Exercise 
NFS  volume 
with  VERIFY 
lOX,  4-14 
with  VERIFY 
lOX,  4-14 
EXIT  command 

lOX,  4-37 
Exit  option 
ACNT,  2-8 
External  header 
task 

specifying,  10-25 

Failure 
hardware 

recovf.'ring,  15-30 
intermittent,  15-29 
media,  15-28 
memory 

power  loss,  15-32 

uncorrectable   error,    15-32 
raeirory  box 

recovering,  15-31 
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Failure  (Cont.) 
processor 

recovering,  15-31 
transient,  15-28 
Fairness  count 

adjustment,  16-3 
Fault 

hardware,  15-28 
system,  15-28 

diagnosing,  15-30 
recovering,  15-30 
/FDX  keyword 
SET  command 
VMR,  10-49 
$FIL 

predefined  syntax  element  in 
NML,  12-41 
$FILE 

predefined  syntax  element  in 
MML,  12-41 
File 

See  also  Account  file 
specifying 

VMR,  10-3 
symbol  definition,  10-2 

overriding,  10-4 
system  image 

configuring,  10-1 
Executive  data  space  and, 
10-2 
File  size 
in  blocks 

specifying,  4-61 
File-structured  device 
exercising 
lOX,  4-3 
Files-11 
disk 

selecting  for  testing 
lOX,  4-38 
disk  structure 
testing  for  a 
lOX,  4-63 
volume 

protecting  with 
TEMPORARYFILE 
lOX,  4-61 
volume  exercise 
example  of 
lOX,  4-9 
FILESll  command 
lOX 

default  parameters,  4-38 
Fill  characters  option,  10-50 

vertical,  10-64 
FIX  command 

VMR,  10-18 
/FIX  keyword 

INSTALL  command 
VMR,  10-22 
FIX-IN-MEMORY  command 
VMR,  10-18 

command  line  format,  10-18 


FIX-IN-MEMORY  command  (Cont.) 
VMR  (Cont.) 

example,  10-19 
keyword 

/DIR,  10-19 
/NSF,  10-19 
/REG,  10-19 
/RON,  10-19 
Flag 
status 
dsvice 

displaying,  15-9 
list,  15-9 
Flyinj  installs,  12-3 
$FNAM 

predefined  syntax  element  in 
MML,  12-41 
/FO  keyword 

QUE  /SP  command 
MCR,  7-17 
Form  feed 
hardware 

specifying,  10-50 
/FORMFEED  keyword 
SET  command 
VMR,  10-50 
/FORMS  qualifier 

INITIALIZE/PROCESSOR  command 
DCL,  7-17 
Fragment 

pool,  13-2  to  13-5,  13-13 
Fragmentation 

pool,  13-1  to  13-5,  13-7  to 
13-10,  13-12  to  13-13 
FREE  command 

RMD,  6-8 
$FSEP 

predefined  syntax  element  in 
MML,  12-44 
FULL  keyword 
CON  command 

VMR,  10-12 
DISPLAY  command 
CON,  15-9 
Full-duplex  option,  10-49 
Function  commands 
I  OX 

as  a  category,  4-3 

/GBL  keyword 

ASSIGN  command 
VMR,  10-9 
Group  Number  Identification 

definition,  B-1 

Hardware 

failure 

recovering,  15-30 

fault,  15-28 

form  feed  option,  10-50 

horizontal  tab  option,  10-50 
/HE  switch 

CON,  15-6 
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Header 

task 

display  in  RMD,  6-10 

altering  from  MCR,  6-11 
•xternal 

specifying,  10-25 
HELP  conmand 
CON,  15-14 

comnand  line  format,  15-14 
example,  15-14 
lOX,  4-39 
/HPILL  keyword 
SET  command 
VMR,  10-50 
/HHT  keyword 
SET  command 
VMR,  10-50 
HLP  macro 

MML,  12-31 
HRC,  15-2 

erro'  message,  15-38 
task-build  time 

displaying,  15-15 
version  number 

displaying,  15-15 

I/O  counts 

display  in  RMD,  6-12 
I/O  error  report 

lOX,  4-21 
I/O  exercise 

steps,  4-2 

termination,  4-23 
I/O  page 

overmapping,  10-22 
I/O  Queue  Optimization,  16-1 

Cylinder  Scan,  16-1,  16-4 

Elevator,  16-1,  16-4 

Fairnesscount,  16-2 

initiating,  16-1 

messages,  16-4 

Nearest  Cylinder,  16-1,  16-3 

optimization  types,  16-3 

specifying,  10-53 

valid  device,  10-53 
I/O  request 

redirecting,  10-33 
lOENT  command 

CON,  15-15 

command  line  format,  15-15 
example,  15-15 
$IFIL 

predefined  syntax  element  in 
MML,  12-41 
$IFILE 

predefined  syntax  element  in 
MML,  12-41 
IFORM,  12-20  to  12-25 
/IM  switch 

VMR,  10-4,  10-41 
/INC  keyword 

INSTALL  command 
VMR,  10-22 


Indirect  command  file 
CON,  15-4 
lOX,  4-6 
VMR,  10-3 
INITIALIZE/PRINTER  command 

DCL,  7-6 
INITIALIZE/PROCESSOR  command 
DCL,  7-14  to  7-19 

/FORMS  qualifier,  7-17 
INITIALIZE/QUEUE  command 

DCL,  7-4,  7-11,  7-13 
INSTALL  command 
VMR,  10-20 

command  line  format,  10-20 

example,  10-26 

keyword 

/AFF,  10-21 
/CKP,  10-21 
/CLI,  10-22 
/FIX,  10-22 
/INC,  10-22 
/lOP,  10-22 
/PAR,  10-22 
/PMD,  10-23 
/PRI,  10-23 
/PRO,  10-23 
/RON,  10-24 
/ROPAR,  10-24 
/SEC,  10-24 
/SLV,  10-24 
/SYNC,  10-25 
/TASK,  10-25 
/UIC,  10-25 
/XHR,  10-25 
Installation 
DCL,  12-1 
flying,  12-3 
Install ing 

DCL,  12-3 
Interactive  node 

lOX,  4-18 
INTERLEAVE  command 

lOX,  4-40 
Intermediate  form 
DCL 

IFORM 
Interrupt  vector  address 

changing,  15-24 
Interval  report 

lOX,  4-20 
Invalid  Login  Transaction  Block, 

17-29 
/lOP  keyword 

INSTALL  command 
VMR,  10-22 
lOX 

command 

ABORT,  4-23 
BADBLOCKS,  4  -24 
BUFFERSIZE,  4-26 
categories,  4-3 
COMPAREDATA  YES/NO,  4-27 
CONFIGURE,  4-28 
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lOX  (Cont.) 

command  (Cont.) 

CONTROL_C  YES/NO,  4-31 

CTRL/C,  4-30 

DENSITY,  4-32 

description,  4-22 

descriptions,  4-22 

DESELECT,  4-34 

ERRORLIMIT,  4-35 

EXECUTE,  4-36 

EXIT,  4-37 

files,  4-6 

FILESll,  4-38 

HELP,  4-39 

in  interactive  mode,  4-19 

INTERLEAVE,  4-40 

LOGFILE,  4-41 

mode,  4-18 

parameter 

by  device  type,  4-9 

with  FILESll,  4-8 

with  SELECT,  4-8 

with  VERIFY,  4-9 
parameter  list 

for  Files-11,  4-8 

for  NFS  volumes,  4-8 
PARAMETERLIST,  4-42 
PATTERN,  4-46 
PRINTSUMMARY,  4-47 
PROCEED,  4-48 
RANDOM,  4-49 
RANGE,  4-50 
RECORDS,  4-51 
REPORTERRORS  YES/NO,  4-52 
RESTART,  4-53 
RETRIES,  4-54 
RUNTIME,  4-55 
SELECT,  4-56 
SPY,  4-58 
START,  4-59 

summary  with  HELP,  4-39 
SUMMARYTIME,  4-60 
syntax,  4-22 
TEMPORARYFILE,  4-61 
VERIFY,  4-62 
VOLUMECHECK,  4-63 
WAIT,  4-64 
WRITECHECK,  4-65 
considerations  for,  4-1 
controlling  with  CTRL/C,  4-30 
data 

compare  error  report,  4-21 
pattern  checking,  4-27 
transfer  size  of,  4-26 
DECtape  exercising,  4-3 
defaults 

changing  during  task  build, 
4-22 
d  ev  ice 

exercising  steps,  4-2 
status  display,  4-58 
testing 

time  of,  4-55 


lOX  (Cont.) 

disk  exercising,  4-2 

error  message,  4-66 

execution  mode,  4-18 
entering,  4-18 

exercise  parameters 
list  of  general,  4-8 

exiting  from,  4-37 

file-structured  exercising, 
4-3 

increment,  4-5 

indirect  command  files,  4-6 

installation 

on  RSX-llM,  4-4 

on  RSX-llM-PLUS,  4-4 

interleaving  with  Executive, 
4-64 

Interval  report  output 
frequency,  4-60 

invoking 

on  RSX-llM,  4-5 
on  RSX-llM-PLUS,  4-5 
when  installed,  4-5 
vhen  not  installed,  4-5 
with  an  Increment,  4-5 
without  an  increment,  4-5 

nonf ile-structured  exercising, 
4-3 

output  type 

activity  report,  4-19 
interval  report,  4-20 
summary  report,  4-20 

parameter 

command  exercising  magnetic 

tape,  4-11 
default  overriding  with 

FILESll,  4-38 
default  overriding  with 

SELECT,  4-56 
default  shown  with 

PARAMETERLIST,  4-42 
device-dependent  exercise, 

4-8 
exercising    Files-11    volumes, 

4-9 
exercising  NFS  volume,  4-14 
list  of  general  exercise, 
4-8 

parameter  command 
category,  4-3 

pattern 

altering  test,  4-46 
displaying  test,  4-46 

restarting,  4-53 

RSX-llM 

running    from,    4-36 

running    steps,    4-2 

selecting 

devicec,    4-7 

Files-11    volume,    4-7 

NFS  volume,    4-7,    4-62 

NFS   volume   with   VERIFY,    4-7 

starting,    4-59 
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lOX    (Cont.) 

tape   exercising,    4-2 
task   termination,    4-18 
task-build   file 

location  of,    4-22 
termination,    4-37 

using    PROCEED,    4-48 
test   configuration,    4-28 

adding   units,    4-6 

displaying,    4-7 

setting   up,    4-6 
testing 

removing   devices    from,    4-34 
wait-for-event    flag,    4-64 
write-check,    4-65 

$JSR 

predefined   syntax   element    in 
MML,    12-45 

Keyword 
VMR,    10-4 

Library 
UIC 

specifying,    10-50 
/LIBUIC   keyword 
SET  command 
VMR,    10-50 
LINE   FEED    key 

generating   task    list 
PUT,    13-8 
/LINES  keyword 
SET  command 
VMR,    10-51 
LINK  command 
CON,    15-16 

command   line   format,    15-16 
example,    15-16 
LIST  command 
CON,    15-17 

command   line   format,    15-17 
example,    15-17 
List  option 

ACNT,    2-6    to   2-7 
$LOAD 

predefined  syntax   element   in 
MML,    12-45 
LOAD  command 
VMR,    10-27 

command   line    format,    10-27 

example,    10-28 

keyword 

/CTB,    10-27 
/PAR,    10-JI7 
/SIZE,    10-27 
Load   test 

UBTP,    9-2 
Log    file 

disabling,  3-5 
example,  3-8 
reading,  3-8 
reassigning,  3-6 


Log  file  (Cont.) 

task  communication  to,  3-2 

use  of  log  file  defaults,  3-6 

using  PIP  to  read,  3-8 
LOGPILE  YES/NO  command 

lOX,  4-41 
Logg 1 ng 

console  output,  3-1 

messages 

Console  Logger,  3-2 
Logical  block 

RCT,  5-2 
Logical  name 

assigning,  10-9 
Logical  unit  number 

See  LUN 
LOGICAL  UNIT  NUMBERS  coMiand 

VMR,  10-29 
Login 

disabling,  10-51 

enabling,  10-51 
Login  Transaction  Block,  17-32 
/LOGON  keyword 

SET  command 
VMR,  10-51 
/LOWER  keyword 

SET  command 
VMR,  10-51 
Lowercase  character 

converting,  10-51 
$LUIC 

predefined   syntax   element    in 
MML,    12-45 
LUN 

assignment 

changing,    10-32 
displaying,    10-29 
LUN   command 

VMR,    10-29 

command    line    format,    10-29 
example,    10-29 


Macro  MetaLanguage 

See  MML 
Magnetic    tape 
density 

displaying    in    lOX,    4-32 

specifying    in    lOX,    4-32 
exercise 

example,   4-11 

using  SELECT,  4-11 
exercising 

in  lOX,  4-2 
records  tested,  4-51 
retries  upon  error,  4-54 
testing 

altering  record  count,  4-51 
/MAIN  keyword 
SET  command 

VMR,  10-51 
MAP  macro 

MML,  12-31  to  n-34 
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Napping 

DCL    to    MCR,    12-20    to    12-25, 
12-34 
Naatat    connand    tabic 

DCL,    12-6    to    12-12,    12-17    to 
12-20,    12-46    to    12-47 
/NAXEXT  keyword 
SET  conmand 
VMR,    10-53 
MCR,    7-1,    7-12    to   7-13,    11-1    to 
11-2,    11-5,    12-1,    12-20    to 
12-25»    12-34 
CLI   default,    2-3 
command 

testing    in   UETP,    9-3 
mapping   to  DCL,    12-20   to 

12-25,    12-34 
relationship  with  VMR,    10-1 
Media 

failure,    15-28 
Member   Number    Identification 

definition,   B-2 
Memory 
box 

adding,    15-23 
failure 

recovering,    15-31 
information 

displaying,    15-9 
removing,    15-20 
compacting    sp«ce 

See   SIIF 
display 

See   RMD 
failure,    15-31 
maximum   sire  of,    10-41 
Message 
eL'ror 

CON,  15-36 
HRC,  15-38 
recording 

by  Console  Logger,  3-2 
size  for  console  output,  3-2 
time-stamping 

by  Console  Logger,  3-2 
VMR,  10-76 
Metalanguage,  12-12 

general  description,  12-13  to 
12-15 
MML,  12-5  to  12-6,  12-9,  12-15 
to  12-17 
AND  macro,  12-25  to  12-26 
BC  macro,  12-26 
EOT  macro,  12-27 
BS  macro,  12-26 
BST  macro,  12-27  to  12-28 
CBM  macro,  12-28 
CCBM  macro,  12-28 
COP  macro,  12-29 
DIR  macro,  12-30 
DMA?  macro,  12-31  to  12-34 
ERR  macro,  12-30 
HLP  macro,  12-31 


NML  (Cont.) 

MAP  macro,  12-31  tc  12-34 

NO  macro,  12-35 

OCOP  macro,  12-29 

OPT  macro,  12-35  to  12-36 

OPTR  macro,  12-35  to  12-36 

predefined  syntax  elements, 
12-39  to  12-45 

PRO  macro,  12-36  to  12-37 

QUA  macro,  12-37  to  12-38 

TST  macro,  12-39 
Modify  option 

ACNT,  2-5  to  2-6 
Modifying 

commands 
DCL,  12-12 
Monitor  Console  Routine 

See  MCR 
Mount  Device  Tr/«')saction  Block, 

17-30 
MOUNT/FOREIGN  command 

Shadow  Recording,  18-3 
MSCP  disk 

RCT 

address  space,  5-2 

bad  block  handling,  5-3 


/NETUIC  keyword 
SET  comnond 
VMR,  10-53 
$NEW 

predefined  syntax  element  in 
MML,  12-44 
$NFIL 

predefined  syntax  element  in 
MML,  12-41 
$NFILE 

predefined  syntax  element  in 
MML,  12-41 
NFS 

exercise 

example  of,  4-14 
testing 

range  of  blocks,  4-50 
volume 

altering  range  of  test 

blocks,  4-50 
displaying  range  of  test 

blocks,  4-50 
error  retries,  4-54 
selecting  with  SELECT,  4-56 
selecting  with  VERIFY,  4-62 
NO  macro 

MML,  12-35 
$NOD 

predefined  syntax  element  in 
MML,  12-41 
$NODE 

predefined  syntax  element  in 
MML,  12-41 
/NOMSG  switch 
CON,  15-6 
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Mon£lle-structur«d  •xarcising 

lOX,  4-3 
/NSP  keyword 
FIX  connand 
VMR,  10-19 
$NULL 

pr«d*£lned  syntax  elamant  in 
HML,  12-45 
$NUN 

pradafinad  syntax  alamant  in 
MML,  12-39 


OCOP  macro 

NML,  12-29 
$ODEV 

predefined  syntax  element  in 
MML,  12-42 
$ODEVE 

predefined  syntax  element  in 
MML,  12-42 
OFFLINE  command 
CON,  15-18 

command  line  format,  15-19 

example,  15-19 

keyword 

ALL,  15-19 
OFFLINE  MEMORY  command 
CON,  15-20 

command  line  format,  15-20 
example,  15-20 
ONLINE  command 
CON,  15-21 

command  line  format,  15-21 

example,  15-22 

keyword 

ALL,  15-21 
ONLINE  MEMORY  command 
CON,  15-23 

command  line  format,  15-23 
example,  15-23 
$ONUM 

predefined  syntax  element  in 
MML,  12-40 
/OPT  keyword 
SET  command 
VMR,  10-53 
OPT  macro 

MML,,  12-35  to  12-36 
OPTR  macro 

MML,  12-35  to  12-36 
$OSEP 

predefined  syntax  element  in 
MML,  12-44 
$OUIC 

predefined  syntax  element  in 
MML,  12-42 
$OUICE 

predefined  syntax  element  in 
MML,  12-42 
OWNER  command 
RMO,  6-9 


Page 

display 
RMD,  6-1 
Paper  tape 

saving  system  on,  10-40  to 
10-41 
PAR  command 
VMR,  10-30 

command  line  format,  10-30 
example,  10-30 
/PAR  keyword 

INSTALL  command 

VMR,  10-22 
LOAD  command 
VMR,  10-27 
SET  command 
VMR,  10-54 
Parameter 
lOX 

command  category,  4-3 
default  overriding  with 

FILESll,  4-38 
default  overriding  with 

SELECT,  4-56 
default  shown  with 

PARAMETERLIST,  4-42 
device-dependent  exercise, 

4-8 
exercising  Files-11  volumes, 

4-9 
exercising  magnetic  tape, 

4-11 
exercising  NFS  volume,  4-14 
list  of  general  exercise, 
4-8 
PARAMETBRLIST  command 
lOX,  4-42 

displaying  buffer  space, 

4-42 
displaying  defaults,  4-42 
Parser  table 

DCL,  12-6  to  12-12,  12-17  to 
12-20,  12-46  to  12-47 
Partition 

common,  14-1 

CPU,  10-54 

creating,    10-51,    10-54 

device,    10-51,    10-54 

eliminating,  10-52,  10-54 

fragmentation,  14-3 

information 

displaying,  10-30 
main,  10-51,  10-54 
pool,  10-54 
size 

specifying,  10-51,  10-54 
system-controlled,  14-1 
boundary 

moving,  10-47,  10-63 
type,  10-51,  10-54 
user-controlled,  14-1 
PARTITION  DEFINITIONS  command 
VMR,  10-30 


Index-14 


INDEX 


Passiford 

adding  to  account  antiry,  2-3 
changing,  2-2>  2-5 
charactara,  2-3 
containad  in  account  antry, 

2-1 
displaying,  2-4 
Pattarn 
I  OX 

altar ing  tast,  4-46 
displaying  tast,  4-46 
PATTERN  coiunand 

lOX,  4-46 
Paripharal  Intarchanga  Program 

5aa  PIP  utility 
PIP  utility 
account  fila 
copying,  2-2 
ax tend ing,  2-2 
/PLCTL  keyword 
SET  command 
VMR,  10-55 
PMD 

requesting,  10-23 
/PHD  keyword 

INSTALL  command 
VMR,  10-23 
PMT 

aborting,  13-12 

tasks,  13-7  to  13-9,  13-11 
to  13-12 
assembling,  13-1 
checkpointing,  13-5,  13-11 
internal  cycle  interval,  13-5, 

13-11 
LINE  FEED  key,  13-8 
message  to  console 

extreme  fragmentation,  13-7 
low  pool  state,  13-6 
message  to  terminals 
cycle  interval,  13-6 
extreme  fragmentation,  13-7 
low  pool  state,  13-6,  13-11 
modifying,  13-11  to  13-12 
overview,  13-3 
PMTBLD.CMD,  13-10  to  13-12 
pool  use  controls,  13-5, 

13-12 
preventing 

invocation  of  TKTN,  13-7 
tasks  from  executing,  13-7 
response 

extreme  fragmentation,  13-1, 
13-3  to  13-4,  13-7  to 
13-10,  13-12 
general  fragmentation,  13-3 

to  13-4 
pool  condition,  13-1,  13-3 

to  13-4 
pool  state,  13-3  to  13-5 
RETURN  key,  13-8 
stopping,  13-5 
Task  Builder  options,  13-10 


PMT  (Cont.) 

task-building,  13-1 
unstopping,  13-5 
PMTBLD.CMD,  13-10  to  13-12 
Pool 

allocation  failure,  13-2 
condition 

Executive  response,  13-1, 

13-4 
fluctuation,  13-4 
high,  13-4 
low,  13-4 
PMT  response,  13-1,  13-3  to 

13-4 
relationship  to  pool  limit, 
13-2 
controls 

PMT,  13-5,  13-12 
event,  13-1 

fragment,  13-2  to  13-5,  13-13 
fragmentation,  13-9 

affecting  pool  state,  13-3 
extreme,  13-1  to  13-4,  13-7 

to  13-10,  13-12 
general,  13-2  to  13-4 
reducing,  13-13 
free,  13-2 
limit 

See  also  SET,  /PLCTL 
relationship  to  pool 

condition,  13-2,  13-4 
monitor  code 

See  Executive 
monitor  interface 

See  Executive 
monitoring,  13-1 
parameters 

setting,  10-55 
secondary 

installing  task  in,  10-24 
use 

displaying,  10-59 
SET  /PLCTL  command,  13-2, 

13-12  to  13-13 
size 

displaying,  10-56  to  10-57 
increasing,  10-56 
specifying,  10-57 
state 

affected 

by  pool  condition,  13-3 
by  pool  fragmentation, 
13-3 
high,  13-11,  13-13 
low,  13-11,  13-13 
overriding  Executive 

notification,  13-5 
PMT  response,  13-3  to  13-4 
system  transition,  13-4 
/POOL  keyword 
SET  command 
VMR,  10-56 
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Pool  Monitor  Task 

S««  PNT 
/POOLSIZE  koyirard 
SET  coawand 
VMR,  10-57 
Postaortaa  Duap 

S«e  PHD 
Potrar 
loss 

racovaring,  15-32 
Pradafinad  syntax  alasiant 

MNL,  12-40 
Pradafinad  syntax  alaaants 

NML,  12-39,  12-41  to  12-45 
/PRI  kayword 
ALTER  conmand 

VMR,  10-8 
INSTALL  command 
VMR,  10-23 
Primary  disk  arrors,  18-10 
Print  Daspoolar  Transaction 

Block,  17-32 
PRINTSUMMARY  command 

lOX,  4-47 
/PRIV  kayword 
SET  command 
VMR,  10-57 
Privilaga 
terminal 

specifying,  10-57 
/PRO  keyword 

INSTALL  command 
VMR,  10-23 
PRO  macro 

MML,  12-36  to  12-37 
$PROC 

predefined  syntax  element  in 
MML,  12-44 
PROCEED  command 

lOX,  4-48 
Processor 
failure 

recovering,  15-31 
halting,  8-4,  8-6 
information 

displaying,  15-9 
placing 

on  line,  15-21 
Prompting 

CLI,  11-7  to  11-9 
$PRONC 

predefined  syntax  element  in 
MML,  12-44 
Protection 

file,  2-2 
Prototype  task 

batch  processor,  7-1 
despool,  7-1 
PRT...,  7-7 
/PUB  keyword 
SET  command 
VMR,  10-57 


QMG,  7-1 

stopping 

using  SHUTUP,  8-4,  8-6 
QMGCLI,  7-1  to  7-2 
$OTRAN,  17-18 
$0TRAN1,  17-19 
$QTRAN2,  17-20 
QUA  macro 

NML,  12-37  to  12<38 
QUE  /AS  command 

NCR,  7-8,  7-12,  7-22 
QUE  /CR  command 

NCR,  7-4,  7-11,  7-13 
QUE  /DEA  command 

NCR,  7-22 
QUE  /DEL  command 

NCR,  7-19 
QUE  /DEL:Q  command 

NCR,  7-20 
QUE  /KIL  command 

NCR,  7-25 
QUE  /SP  command 

DCL,  7-18 

MCR,  7-6,  7-13  to  7-17,  7-19 
/FO  keyword,  7-17 
QUE  /STA  command 

MCR,  7-26  to  7-31 
QUE  /STA: QMG  command 

MCR,  7-3,  7-26  to  7-27 
QUE  /STO  command 

MCR,  7-23  to  7-25 
QUE  /STO: QMG  command 

MCR,  7-23 
QUE  /STO: QUE  command 

MCR,  7-23 
QUE  /UNSP  command 

MCR,  7-20  to  7-22 
Queue  Manager 

See  QMG 

$R50 

predefined  syntax  element  in 
MML,  12-41 
RANDOM  command 

lOX,  4-49 
RANGE  command 

lOX,  4-50 
RATE  command 

RMD,  6-8  to  6-9,  6-11  to 
6-12A 
ROT,  5-1 
bad  block 

detection,  5-3 
notification,  5-3 
replacement,  5-3 
replacement  completion,  5-4 
levectoring,  5-4 
installing,  5-2 
logical  block,  5-2 
recovery  techniques  for  disks, 

5-1 
relationship 

Error  Logger,  5-5 
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RCT  (Cont.) 

relationship  (Cont.) 

RSX-llM  utilities,  5-5 
replacement  block,  5-2 
primary,  5-4 
secondary,  5-4 
RD:,  15-2 
REA  command 

VMR,  10-32 
Read 

from  console  terminal,  3-3 
nondestructive 

NFS  volumes,  4-62 
Read-pass-all  option,  10-58 
REASSIGN  command 
VMR,  10-32 

command  line  format,  10-32 
example,  10-32 
Reconfiguration 
service,  15-1 

command  interface,  15-1 
driver,  15-2 
initiating,  15-4 
task,  15-2 
system,  15-1 
RECORDS  command 

lOX,  4-51 
Recovery  techniques 
RCT 

for  d'sks,  5-1 
RED  command 

VMR,  10-33 
REDIRECT  command 
VMR,  10-33 

command  line  format,  10-33 
example,  10-33 
/REG  keyword 
FIX  command 

VMR,  10-19 
REMOVE  comnand 

VMR,  10-34 
UNFIX  command 
VMR,  10-74 
Region 
common 

fixing,  10-19 
read-only 

specifying,  10-24 
task 

sharing,  10-25 
unfixing,  10-74 
fixing,  10-18 

restrictions,  10-18 
loading 

restrictions,  10-18 
removing,  10-34 
REM  command 

VMR,  10-34 
/REMOTE  keyword 
SET  command 
VMR,  10-57 
REMOVE  command 
VMR,  10-34 


REMOVE  command  (Cont.) 
VMR  (Cont.) 

command  line  format,  10-34 

example,  10-34 

keyword 

/REG,  10-34 
Replacement  block 
RCT,  5-2 

primary,  5-4 
secondary,  5-4 
Report 
interval 

output  frequency,  4-60 
REPORTERRORS  YES/NO  command 

lOX,  4-52 
$RESET 

predefined  syntax  element  in 
NML,  12-44 
Resource  Accounting,  17-1 
See  also  Transaction  file 
commands,  17-4 

SET  ACCOUNTING,  17-4,  17-10 
SHOW  ACCOUNTING/- 

DATATRIEVE,  17-4,  17-18 
SHOW  ACCOUNTING/- 

INFORMATION,  17-4, 
17-12 
SHOW  ACCOUNTING/- 

TRANSACTION_FILE,  17-4, 
17-13 
START/ ACCOUNTING,  17-4  to 

17-5 
STOP/ ACCOUNTING,  17-4, 
17-11 
crash  reason,  17-6 
device  statistics  example, 

17-8 
interface  for  creating 
transactions 
$QTRAN,  17-18 
SQTRANl,  17-19 
$QTRAN2,  17-20 
messages,  17-42 
privileged  task  interface, 

17-22 
scan  rate,  17-6 
secondary  pool,  17-5 
statistics  scan,  17-6 
stopping 

using  SHUTUP,  8-6 
system  resources,  17-41 
system  statistics,  17-5 
task  accounting,  17-7 
using  DATATRIEVE'll  for  an 
accounting  report,  17-17 
Resource  Monitoring  Display 

See  RMD 
RESTART  command 

lOX,  4-53 
RETRIES  command 

lOX,  4-54 
RETURN  key 
ex  i  t  i  ng 
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RETURN  key  (Cont.) 
exiting  (Cont.) 
PMT,  13-8 
Revector  control  table 
RCT 

status  codes,  5-2 
RL02  exercise 

lOX,  4-9 
RMD 

altering 

active  task  displa 

MCR,  6-9 
display  from  setup 

6-7 
I/O  counts 

from  setup  page, 
memory  display,  6- 

from  MCR,  6-8 
system  statistics 
from  MCR,  6-12B 
from  setup  page, 
task  display 

from  setup  page, 
6-11 
command  line 

to  install,  6-2 
to  invoke,  6-2 
DEVICE  command,  6-12 
display  page,  6-1 
displaying 

active  task,  6-8 
commands  to  alter 

6-11 
conmmands  to  alter 

counts,  6-12 
help,  6-3 
I/O  counts,  6-12 
memory,  6-4 
RSX-llM-PLUS  only, 
system  statistics, 
task  header,  6-10 
error  message,  6-13D 
FREE  command,  6-8 
I/O  counts  display 

altering  from  MCR, 
installing,  6-2 

individual  termina 
introduction  to,  6-1 
invoking,  6-2 

at  terminal,  6-2 
OWNER  command,  6-9 
RATE  command,  6-8  to 

6-11  to  6-12A 
running 

on  slaved  terminal 
setup  page,  6-1,  6-7 
TASK  command,  6-9,  6 
task  header  display 
altering  from  MCR, 
task-build  command  f 

nodifying,  6-1 2C 
using 

individual  termina 


y  from 
page. 


8 


6-12 

( 

6-12B 
6-9, 


task, 
I/O 


6-11 
6-12A 


6-12A 


RMT,  11-2 
/RNDC  keyword 
SET  command 
VMR,  10-58 
/RNDH  koyword 
SET  command 
VMR,  10-58 
/RNDL  keyword 
SET  command 
VMR,  10-58 
/RON  keyword 
FIX  command 

VMR,  10-19 
INSTALL  command 

VMR,  10-24 
UNFIX  command 
VMR,  10-74 
/ROPAR  keyword 
INSTALL  command 
VMR,  10-24 
Round-robin  scheduling 
duration 

specifying,  10-58 
priority 

specifying,  10-58 
/RPA  keyword 
SET  command 
VMR,  10-58 
/RSI  keyword 
RUN  command 
VMR,  10-36 
RSXll.SYS 

See  Account  file 
RUN  command 
VMR,  10-36 

comuand  line  format,  10-36 

to  10-38 
example,  10-39 
keyword 

/RSI,  10-36 
/UIC,  10-37 
RUNTIME  command 
lOX,  4-55 

SAB 


Resource  Accounting,  17-3 

1,  6-2 

SHnity  timer 

activating,  15-24 

SAVE  command 

VMR,  10-40 

command  line  format,  10-40 

6-9, 

example,  10-41 

keyword 

/BOOT,  10-40 

,  6-2 

/DENS,  10-40 

Scan  rate 

-11 

Resource  Accounting,  17-6 

/SEC  keyword 

6-11 

INSTALL  command 

ile 

VKR,  10-24 

Secondary  disk  errors,  18-10 

Secondary  pool 

1,  6-2 

installing  task  in,  10-24 
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Secondary  pool  (Cont.) 

Raaourc*  Accounting,  17-5 
uac 

diaplaying,  10-59 
/SECPOL  keyword 
SET  coaaand 
VMR,  10-59 
SELECT  coaaand 

lOX,  4-56 
$SEP 

pradafinad  ayntax  alaaant  In 
MML,  12-44 
Sarlal  coaaand  procaaaing 

CLI,  11-9 
Sarial  Oaapoolar  Taak 

Saa  Oaapoolar 
SET 

/PLCTL 

aatabliahing 

pool  lialta,  13-2,  13-12 

to  13-13 
task  priority,  13-13 
paraaatar  defaults,  13-13 
SET  ACCOUNTING 

Rasourca  Accounting,  17-4 
Sat  Accounting  Transaction 

Block.  17-28 
SET  coaaand 
CON,  15-24 

coaaand  Una  foraat,  15-24 

axaapla,  15-25 

option 

ALARM,  15-24 
CSR,  15-24 
TIMER,  15-24 
VBC,  15-24 
I/O  Queue  Optini zation,  16-2 
Shadow  Recording,  18-10 
VMR,  10-43 

coaaand  line  foraat,  10-44 

exaaple,  10-66 

keyword 

/ABAUD,  10-46 
/ATP,  10-46 
/BOT,  10-47 
/BRO,  10-48 
/BUP,  10-48 
/CRT,  10-48 
/EBC,  10-48 
/ECHO,  10-49 
/ESCSEQ,  10-49 
/PDX,  10-49 
/FORMFEED,  10-50 
/HFILL,  10-50 
/HHT,  10-50 
/LIBUIC,  10-50 
/LINES,  10-51 
/LOGON,  10-51 
/LOWER,  10-51 
/MAIN,  10-51 
/MAXEXT,  10-53 
/METUIC,  10-53 
/OPT,  10-53 


SET  coaaand  (Cont.) 
VMR 

keyword  (Cont.) 
/PAR,  10-54 
/PLCTL,  10-55 
/POOL,  10-56 
/POOLSIZE,  10-57 
/PRIV,  10-57 
/PUB,  10-57 
/REMOTE,  10-57 
/RNDC,  10-58 
/RNDH,  10-58 
/RNDL,  10-58 
/RPA,  10-58 
/SECPOL,  10-59 
/SLAVE,  10-59 
/SPEED,  10-59 
/SUB,  10-60 
/SMPC,  10-61 
/SWPR,  10-61 
/SYSUIC,  10-61 
/TERM,  10-62 
/TOP,  10-63 
/TYPEAHEAD,  10-64 
/UIC,  10-64 
/VFILL,  10-64 
/WCHK,  10-63 
/IfRAP,  10-65 
Shadow  Recording 
catchup,  18-1 
coaaands,  18-4 
ABORT,  18-7 
CONTINUE,  18-8 
DISPLAY,  18-9 
START,  18-5 
STOP,  18-6 
aessages,  18-11 
preparing  for,  18-2 
restarting  after  errors  on 

disk,  18-11 
shadowed  pair,  18-1 
UMB  control  block,  18-9 
Shadowed  pair,  18-1 
SHF 

algorithas 

first  pass,  14-5 
second  pass,  14-6 
conventions,  14-1 
installation  of,  14-4 
aonitoring  with  RMD,  14-4 
overhead,  14-4 
perforaance,  14-4 
reaoval  of,  14-5 
shuffling 

dynaaic  coaaon  regions, 

14-5 
fixed  tasks,  14-5 
partition  sections,  14-S 
static  coaaon  regions,  14-5 
size,  14-4 
$SHFCT 

Chang IT'^  cont9nts,  14-4 

is'dtm,   i.;-4 


Index-19 


INDEX 


SHOW  ACCOUNTING  Jommands,  17-3 
SHOM  ACCOUNTING/- 

TRANSACTION_riLE 
P.asource  Accounting,  17-4 
SHOW  ACCOUNTING/DATATRIEVE 

Resource  Accounting,  17-4 
SHOW  ACCOUNTING/INFORMATION 
Resource  Accounting,  17-4 
Shuffler 

See  SHF 
SHUTUP 

checkpointing 

read/write  commons,  8-6 
completion  notification,  8-3 
deallocating 

checkpoint  space,  8-4,  8-6 
dismounting 

devices,  8-4,  8-6 
halting 

processor,  8-4,  8-6 
invoking,  8-1 
logging  off 

logged-in  terminals,  8-4, 
8-6 
logins 

disabling,  8-2  to  8-3 
enabling,  8-3 
prerequisites,  8-1 
redirecting 

console  terminal,  8-4,  8-6 
shutdoiim 

RSX-llM  system,  8-4  to  8-6 
RSX-llM-PLUS  system,  8-6  to 
8-8 
SHUTUP.CMD,  8-1,  8-3 

submitting  to  Indirect,  8-3 
to  8-4,  8-6 
stopping 

Console  Logger,  8-4,  8-6 
ERRLOG,  8-4,  8-6 
Queue  Manager,  8-4,  8-6 
Resource  Accounting,  8-6 
task-build  file,  8-3 
terminating,  8-2 
warning  message,  8-2 
SHUTUP.CMD 
example,  8-4 
installing 

tasks,  8-1,  8-3 
overview,  8-3 
relationship  to  SHUTUP  task, 

8-3 
submitting  to  Indirect,  8-3 

to  8-4,  8-6 
timeout  interval,  8-3 
/SIZE  keyword 
LOAD  command 
VMR,  10-27 
/SLAVE  keyword 
SET  cowaand 
VMR,  10-59 
/8LV  keytrord 

INSTALL  command 


/SLV  keyword  (Cont.) 

INSTALL  command  (Cont.) 
VMR,  10-24 
Sort  option 

ACNT,  2-8 
/SPEED  keyword 

SET  command 
VMR,  10-59 
Spooling 

transoarent,  7-1 
SPWN$  directive 

lOX 

in  EXECUTE  command,  4-36 
SPY  command 

lOX,  4-58 
START  command 

DCL,  7-26  to  7-27 

lOX,  4-59 

Shadow  Recording,  18-5 
START/ ACCOUNTING 

Resource  Accounting,  17-4 
START/PROCESSOR  command 

DCL,  7-27  to  7-31 
START/QUEUE  command 

DCL,  7-26  to  7-27 
START/gUEUE/MANAGER  command 

DCL,  7-3,  7-26  to  7-27 
Static  common  region 

checkpointing,  14-3 

resident  common,  14-2 

resident  libraries,  14-2 

shuffling,  14-5 
Statistics 

system 

display  in  RKD,  6-13D 
Statistics  scan 

Resource  Accounting,  17-6 
Status 

device 

emitting,    15-12 

displaying 

during  lOX  exercising,  4-58 
Status  flag 

device 

displaying,  15-9 
list,  15-9 
STOP  command 

DCL,  7-23 

Shadow  Recording,  18-6 
STOP/ABORT  command 

DCL,  7-25 
STOP/ACCOUNTING 

Resource  Accounting,  17-4 
STOP/PROCESSOR  command 

DCL,  7-24  to  7-25 
STOP/QUEUE  command 

DCL,  7-23 
STOP/QUEUE/MANAGER  command 

DCL,  7-23 
/SUB  keyword 

SET  command 
VMR,  10-60 


e 
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Subpartition 

creating,  10-60 
•lininatlng,  10-61 
Suaaary  report 

generated  by  PRINTSUMMARY, 

4-47 
lOX,  4-20 
SUNHARYTINE  conaand 

lOX,  4-60 
SWITCH  conaand 
CON,  15-26 

coaaand  line  foraat,  15-26 
exaaple,  15-26 
/SWPC  keyword 
SET  coaaand 
VMR,  10-61 
/SWPR  keyword 
SET  coaaand 
VMR,  10-61 
$SY 

predefined  syntax  eleaent  in 
MML,  12-44 
Syabol 

definition  file,  10-2 
overriding,  10-4 
/SYNC  keyword 
INSTALL  coaaand 
VMR,  10-25 
Syntax  eleaent 

predefined  MML,  12-39  to 
12-40 
Syntax  eleaents 

predefined  MML,  12-41  to 
12-45 
SYSGEN 

DCL,  12-2 
Systea 

bootstrapping,  10-41 
configuration 
device 

adding,  15-21 
reaoving,  15-18 
duplicating,  15-7,  15-17 
inforaation 

displaying,  10-12,  15-9 
meaory  box 

adding,  15-23 
reaoving,  15-20 
fault,  15-28 

diagnosing,  15-30 
recovering,  15-30 
file  naaing 

convention,  B-4 
file  types,  B-5  to  B-6 
iaage 
file 

configuring,  lQ-1 
Executive  data  space  and, 
10-2 
foreign 

writing,  10-4 
saved 

aaxiaua  site  of,  10-41 


Systea  (Cont.) 
iaage  (Cont.) 
writing,  10-40 

supported  device,  10-40 
aultiprocessor 

diagnostic,  15-32 
stand-alone  aaintenance, 
15-32 
aultiuser  protection 
login 

disabling,  10-51 
enabling,  10-51 
reconfiguration,  15-1 
saving,  10-40 

supported  device,  10-40 
shutdown  task 

See  SHUTUP 
statistics 

Resource  Accounting,  17-5 
statistics  display 

RMD,  6-12A 
UIC 

specifying,  10-61 
Systea  Account  Block,  17-26 
Systea  Tiae  Change  Transaction 

Block,  17-31 
Systea-controlled  partition, 
14-1 
conventions,  1^-2 
definition,  14-2 
f ragaentation 

causes  of,  14-3 
subpartitions  of,  14-2 
waiting  tasks,  14-2 
/SYSUIC  keyword 
SET  coaaand 
VMR,  10-61 

TAB 

Resource  Accounting,  17-3 
Tab 

hardware  horizontal 
specifying,  10-50 
Table 

revector  control  in  ROT 
status  codes,  5-2 
TAS  coaaand 
VMR,  10-70 

coaaand  line  foraat,  10-70 
exaaple,  10-70 
Task 

aborting 

using  PMT,  13-7  to  13-9, 
13-11  to  13-12 
active 
display 

altering  froa  MCR,  6-9 
canceling,  10-11 
CLI 

installing,  10-22 
reaoving,  10-35 
coaaon  region 
fixing,  10-19 
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Task  (Cont.) 

connon  region  (Cont.) 

sharing,  10-25 

unfixing,  10-74 
display,  6-8 
dumping,  10-23 
execution  termination,  4-23 
extending,  10-22 

maximum  size 

specifying,  10-53 
external  header 

specifying,  10-25 
fixing,  10-18 

restriction,  10-18 
header  display 

RMD,  6-10 

altering  from  HCR,  6-11 
initiation 

I  OX 

EXECUTE  command,  4-36 
installed 

information 

displaying,  10-70 
installing,  10-20 

checkpointable,  10-21 

secondary  pool,  10-24 
LUNs 

reassigning,  10-32 
name 

CLI,  11-4 
naming,  10-25 
nonprivileged 

subject  to  pool  use 

controls,  13-5,  13-13 
nonshuf f leable 

fixing,  10-19 
overmapping  I/O  page,  10-22 
priority 

base,  13-5,  13-13 

changing,  10-8 

specifying,  10-23 
removing,  10-34 
rescheduling,  10-36 
running,  10-36 
slaved 

specifying,  10-24 
UIC 

specifying,  10-25,  10-37 
unfixing,  10-74 
Task  Account  Block,  17-24 
Task  accounting 

Resource  Accounting,  17-7 
TASK  command 

RMD,  6-9,  6-11 
/TASK  keyword 
INSTALL  command 

VMR,  10-25 
Task-build  command  file 
RMD 

modifying,  6-12C 
Task-build  file 

location  of  lOX,  4-22 


TASKLIST  command 

VMR,  10-70 
TEMPORARYPILE  command 

lOX,  4-61 
$TERM 

predefined   syntax   element   in 
MML,    12-44 
/TERM   keyword 
SET  command 
VMR,    10-62 
Terminal 
baud    rate 

specifying,  10-59 
CRT 

specifying,  10-48 
dual-port 

placing  on  line,  15-22 
switching,  15-22 
local 

specifying,  10-58 
option 

autobaud  detection,  10-46 

backwards  deletion,  10-48 

broadcast,  10-48 

echo,  10-49 

Eight-bit  character,  10-48 

escape- sequence  recognition, 

10-49 
fill  characters,  10-50 

vertical,    10-64 
full-duplex,    10-49 
hardware 

form   feed,    10-50 
horizontal    tab,    10-50 
read-pass-all,    10-58 
typeahead,    10-64 
wrap-around,    10-65 
privilege 

specifying,    10-57 
remote 
baud   rate 

specifying,  10-57 
specifying,  10-57 
slaved 

running   RMD  on,   6-2 
specifying,    10-59 
type 

half-duplex,  10-62 
specifying,  10-62 
standard,  10-62 
UIC 

specifying,  10-64 
Test  configuration 
lOX 

pattern  altering,  4-46 
pattern  displaying,  4-46 
setup,  4-6 
$TI 

predefined  syntax  element  in 
MML,  12-45 
$TIME 

predefined  syntax  element  in 
MML,  12-42 
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Tla* 

displaying,  10-72 
o£  lOX  axercis*,  4-55 
setting,  10-72 
TINE  coflinand 
VKR,  10-72 

counand  lin*  fomat,  10-72 
•xaMpla,  10-72 
TIMER  option 
SET  command 
CON,  15-24 
/TOP  keyword 
SET  command 
VMR,  10-63 
Transaction  £11* 

account  block  linkages,  17-40 
account  blocks,  17-3,  17-21 
system  account  block  (SAB) , 

17-3 
task  account  block  (TAB) , 

17-3 
transaction  account  blocks, 

17-3 
user  account  block  (UAB) , 
17-3 
accumulation  fields,  17-35 
block  diagrams,  17-24 
card  reader  job  data,  17-3 
card  reader  spooling  block, 

17-38 
crash  recovery  block,  17-37 
device  allocation, 

deallocation,  or  dismount 
data,  17-2 
device  mount  data,  17-2 
device  statistics  block, 

17-39 
device  usage  data,  17-3 
disk  accounting  block,  17-37 
example,  17-13 
header  area,  17-34 
in  DATATRIEVE-11,  17-17 
Invalid  login  block,  17-37 
logon  data,  17-2 
offset  definitions,  17-34 
print  despooler  block,  17-38 
print  job  data,  17-2 
set  accounting  block,  17-37 
size,  17-5 

system  account  block,  17-36 
system  data,  17-2 
system  time  change,  17''3 
system  time  change  block, 

17-38 
task  data,  17-1 
user  account  block,  17-35 
user  data,  17-1 
Translator  table 

DCL,  12-6  to  12-12,  12-17  to 
12-20,  12-46  to  12-47 
Transparent  spooling,  7-1 


$TST 

predefined  syntax  element  in 
MML,  12-45 
TST  macro 

MML,  12-39 
$TSTNOT 

predefined   syntax   element   in 
MML      12-45 
/TYPEAHEAD   keytrord 
SET  command 
VMR,    10-64 
Typeahead   option,    10-64 


UAB 

Resource  Accounting,  17-3 
UETP 

console  dialog  example,  9-7 
environment  needed  to  run, 

9-3 
error  message,  9-5 
LOGGER. TSK,  9-5 
system  configuration  module, 
9-5 
error  messages 
NULl.TSK,  9-6 
QTRUN.TSK,  9-6 
error  reporting,  9-4 
load  test 

purpose,  9-2 

requirements  for  RSX-llM, 
9-2 
modules,  9-1 

operating  procedures,  9-4 
requirements  in  RSX-llM,  9-3 
requirements  in  RSX-llM-PLUS, 

9-3 
running,  9-4 
lOX,  9-2 
utilities,  9-2 
structure,  9-1 
testing 

interactive  utilities,  9-3 
MCR  commands,  9-3 
UFD 

definition,  B-1 
system 

example,  B-3  to  B-4 
$UIC 

predefined  syntax  element  in 
MML,  12-42 
UIC 

authorized,  2-1 

contained  in  account  entry, 

2-1,  2-5,  2-7 
DECnet,  10-53 
default,  10-64 
displaying,  2-4 
distinction  by  password,  2-1 
library,  10-50 
system,  10-61 
task,  10-25 
terminal,  10-64 
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/UIC  keyword 

INSTALL  command 

VMR,  10-25 
RUN  command 

VMR,  10-37 
SET  command 
VMR,  10-64 
$UICE 

predefined  syntax  element  in 
MML,  12-42 
UMB  control  block 

Shadow  Recording,  18-9 
UNP  command 

VMR,  10-74 

UNFIX  command 

VMR,  10-74 

command  line  format,  10-74 

example,  10-74 

keyword 

/REG,    10-74 
/RON,    10-74 
UNITS   keyword 
CCN   command 

VMR,    10-12 
DISPLAY  command 
CON,    15-9 
UNL   comitjand 

VMR,    10-75 

UNLINK  command 

CON,  15-27 

command  line  format,  15-27 
example,  15-27 
UNLOAD  command 
VMR,  10-75 

command  line  format,  10-75 
example,  10-75 
User  Account  Block,  17-25 
User  Environment  Test  Package 

See  UETP 
User  File  Directory,  B-1 

See  UFD 
User  Identification  Code 

See  UIC 
User-controlled  partition,  14-1 
Utilities 
interactive 

testing  in  UETP,  9-3 
RSX-llM 

relationship  to  RCT,  5-5 
UETP,  9-2 


VEC  keyword 
CON  command 
VMR,  10-15 
VEC  option 
SET  command 
CON,  15-24 
Vector  address 

changing,  10-12 
VERIFY  command 
lOX,  4-62 

effect  on  NFS  voluae,  4-7 


Vertical  fill  characters  option, 

10-64 
/VFILL  keyword 
SET  command 
VMR,  10-64 
Virtual  Monitor  Console  Routine 

See  VMR 

VMR,  10-1 

command 

line,  10-4 

comment  in,  10-5 
name,  10-4 
parameter,  10-4 
summary,  10-5 
error  message,  10-76 
file  specification,  10-3 
/IM  switch,  10-4 
indirect  command  file,  10-3 
keyword,  10-4 

relationship  with  MCR,  10-1 
starting,  10-1 
terminating,  10-3 
Volume 
Files-ll 

protecting  with 

TEMPORARYFILE,  4-61 
NFS 

block  range  altering,  4-50 
block  range  display,  4-50 
list  of  parameter  commands 

for,  4-8 
retries  upon  error,  4-54 
selecting 

with  lOX,  4-56 
with  VERIFY,  4-62 
selecting 

Files-ll  for  lOX,  4-7 
NFS  for  lOX,  4-7 
VOLUMECHECK  command 
lOX,  4-63 


WAIT  command 

lOX,  4-64 
$WALFN 

predefined  syntax  element  in 
MML,  12-40 
/WCHK  keyword 
SET  command 
VMR,  10-65 
$WDONUM 

(.redefined  syntax  element  in 
MML,  12-40 
$MFIL 

predefined  syntax  element  in 
MML,  12-41 
$WFILE 

predefined  syntax  element  in 
MML,  17-41 
Wildcard 

DISPLAY  command 
CON,  15-10 
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$WOMUM 

predefined  syntax  element  in 
MML,  12-40 
/WRAP  keyword 
SET  command 
VMR,  10-65 
Wrap-around  option,  10-65 
Write  checking 

specifying,  10-65 
Write  lock 

write-back  cache  data 
handling  in  RCT,  5-5 


Write-check 

enabling  in  lOX,  4-65 
WRITECHECK  command 

lOX,  4-65 
$WUIC 

predefined   syntax   element   in 
MML,    12-42 


/XHR  keyword 

INSTALL   comr.ind 
VMR,    10-25 
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Mr  it*  checking, 

specifying,    10-65 
Writ*   lock, 

writ*-back  each*  data, 
handling    in   RCT,    5-4 
Writ«-ch*ck, 

enabling    in    lOX,    4-fi5 
WRITECHECK   conaand, 

lOX,  4-65 


$WUIC, 

pr*d*fin*d  syntax  element  in 
NML,  12-42 


/XHP  keyworJ, 

INSTALL  conmand, 
VMR,  10-25 
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